記事内に広告が含まれる場合があります

X API v2のOAuth 2.0のアクセストクーンはどれ?【Twitter API/GAS】

Twitter(X)予約投稿ツール(GASとスプレッドシート)
2018.11.25

とあるアカウントをtwitter api v2 freeに移行することにしました。

(追記)OAuth 2.0の情報を加筆しました。

X(Twitter)の予約投稿ツールを開発しています。次のリンクから。

スプレッドシートで予約投稿するTwitter BOTツール: Craft Twix
おすすめ:Twitter(X)自動投稿・予約投稿ツール比較！オリジナル自作あり!

GASとTwitter Api(X API)で予約投稿ツールを作った!【PR】

Twitter Api v2のfreeの移行とOAuth!予約投稿の件数!

【PR】twitter api v2 freeの機能を最大限、生かしたCraft Twixを開発しました。

画像複数投稿、動画投稿、ツリー投稿はもちろんWordPressの定期投稿、オリジナル機能搭載です。しかもライセンスはゆるく、転売・転載をしないことを条件に改変を自由としました。

一部分で複数枚画像投稿や動画投稿などもあり、シートも複数あるため多機能です。色分けも工夫してカラフルでわかりやすい感じに。

興味ある方はこちらの記事をみてください!

経緯。

GAS・スプレッドシートでX・Twitter botの自動投稿・予約投稿する
かなり高額でバランスが悪いTwitterAPIの有料化が行われて、いろいろなサービスが終了していきます。使っていたWordPressのプラグインもサービスが終了の模様。 そのためTwitter APIのfree版でGASで運用する簡単なコー
ebookbrain.net

Craft Twixと他のツール比較記事。

【比較】2024年twitter bot(X)の作り方(スプレッドシート)
スプレッドシートを使ったTwitterの自動投稿を提供しています。 1つは2019年頃、販売を開始して今でも使えるもの(長年の実績とも言えますかね)。もうひとつ、Twitter API騒動があったのち、しばらくしたのち開発に着手してリリース
ebookbrain.net

CraftTwix(クラフトツイックス)の販売を開始しました。

スプレッドシートで予約投稿するTwitter BOTツール: Craft Twix

Twitter Api v2のfreeの移行方法【X API】

(追記)移行方法が少し変わったため、その変更点を反映させたものをQiitaに寄稿しました。この記事は細かいエラーなどの対応を残しておきます。

Twitter API v2(X API Free)の使い方・移行(2024年)【GAS】 - Qiita
Twitter API v2(X API Free)の覚書です。少し前に仕様が変わったためそちらも踏まえて書いておきます。Twitter API v2(X API Free)の使い方・移行(202…
qiita.com

Twitterのアカウントを紐づけるものに切り替えておきます。

  1. 画面上の[ 開発者ポータル ]
  2. Twitterでログイン
  3. 画面下の[ Sign up for Free Account ]
  4. 次の画面の入力をこなして登録完了です。

Describe all of your use cases of Twitter’s data and API:

Twitter APIとデータの使い方をすべて説明してと言っていますね。250字以上らしいです。例文はこちらの記事に記載しています。

Twitter Developers Forumやポータルの使い方
覚書です。 Twitter Developersのフォーラムの使い方 日本語で紹介したサイトがなかったので、メモ程度に残しておきます。次の手順で登録はできました。 Sign UpTwitter Discourse Forumsにアカウントへ
mh-story.sakura.ne.jp

次の3つはチェックボックスをチェックするだけです。

You understand that you may not resell anything you receive via the Twitter APIs

Twitter APIで受け取ったものを再販してはダメのようですね。

You understand your Developer account may be terminated if you violate the Developer Agreement or any of the Incorporated Developer Terms

violate(違反)したらterminated(オワコン)だよと言っていますね。

You accept the Terms & Conditions

利用規約に同意する

[Submit] をおします。

既にTwitter Apiを利用している人

既にAPIを使っていた人はここからスタートできます。個人的にv1からの利用者です。まずはTwitter Developersにアクセス。

Twitter Developers

Add Projectから作るとv2が作れましたね。昔作ったアプリは放置のまま、新規で作成する方法を探しましたが、昔作ったアプリがある場合は新規のアプリは作れません。途中までできます。

アプリが作れない

Standalone Appsは今まで作ったアプリです。

v2のアプリは1つです。どうやらv1のアプリもカウントされているらしく、Standalone Appsがあると新しいアプリが作れません。[Create new]がグレーになっています。

アプリを消して作るしかなさそうです。

古いアプリの削除(必要なら)

次の操作をすると新しいアプリが作れるようになります。free版は1つしかアプリを作れません。

画面左から古いアプリを選択 > Delete APP > アプリ名を入力、[Delete APP]のボタンおす

新しいプロジェクトやアプリの削除(必要なら)

登録時に自動的にプロジェクトやアプリが生成されてしまう場合があるようです。名前なども適当なため、一度削除してやりなおしてもいいかもしれません。

画面左からアプリを選択 > Edit > Delete APP > アプリ名を入力、[Delete APP]のボタンおす

画面左からプロジェクトを選択 > Setting > Edit > [Delete Project]のボタンおす

プロジェクトの作成

Progects & Apps > Overview > + Add Project > Progect nameを設定してNext > Uses caseを設定してNext(botの場合はmake a bot) > Project description、プロジェクトの詳細を書いてNext > Create new

プロジェクトの詳細はWordPress to Tweetなど簡単に書けばいいです。この項目は文字数が少ないとダメはないようです。

引用先の記事を参考にしました。ありがとうございます。画像つきで解説されています。

Under the Elevated Section, click the “+ Add Project” button to add a new project.

https://docs.ultimatemember.com/article/1699-social-login-twitter-api-v2-setup

アプリの作成、apiキーの取得

  1. + Add App
  2. Development Staging, Productionのいずれか選択してNext(テスト用だったのでDevelopment を選ぶ)
  3. アプリ名を入れてNext。同じ名前はダメのようです。サイト名+tweetにしておきましょうか。
  4. API Key と API Secret Key、Bearer Tokenが表示されます。

keyはそのときしか見れないようなので、忘れずめもします。忘れた場合、キーを再生成しないといけません。

アプリの作成は回数制限があるようです。何度も作成すると24時間待たされることになります。

keyの再生成

なお、keyは次から再生成できるようです。

画面左の[アプリ名] > Regenerate

アクセストクーンの生成

gasなどを使う場合はアクセストクーンも生成します。

画面左からアプリを選択 > Access Token and Secretの[ Generate ] > コピーしてめもる > Yes, I saved them.

読み込みと書き込み設定

画面左の[アプリ名] > Set Up

アプリにより違いますが、botの場合、想定で設定をします。

ツイートは書き込みが必要なのでRead and Writeにします。

  • Read and Wirte
  • Web App, Automated App or Bot
  • Callback URI / Redirect URL 自サイトのurl(Twitterのurlでもよい、開発でcallbackを使用する場合は後ほど書き換えます)
  • Website URL 自サイトのurl(Twitterのurlでもよい)

最後に[save]をおします。OAuth 2.0 クライアント ID とクライアント シークレットが表示されます。

Done > Yes, I saved it.

Keys and tokensを確認すると、OAuth 2.0 クライアント ID とクライアント シークレットが増えています。

Twitter API v2のfreeは審査はいる?

Suspendされたら、ダウングレードで回避!?

free版はbotしか作れない!?他人のツイートは取得不可?

他人のアカウントができないっていうのはサービスによっては厳しいですね。

free版でダイレクトメッセージはできる!?

できないようですね。まあ、これは迷惑メールが減るのでいいことかもですけど。

ツイートのリンク先は登録している人しか確認できません。

v2にメディアのアップロード、画像添付はない?

まだ昔のものしかないようです。。

実装は後回しですかね…。

また、Twitterのぐだぐだなのでしょうか。。

この日付でもできていないよう。できていないのに止めるのは破綻なので、延長なのでしょうか。

古いapiはまだ動いていますね。

(後日談)画像アップロードも実装しました。

【GAS】ツリー投稿・動画投稿・画像複数枚投稿(media upload)で予約投稿するやり方【Twitter API】
Gasで画像投稿、動画投稿、ツリー投稿、全部実装済みしたため知見がたまりました。 ただ、ツールとして販売することにしてしまったため、うまくいかなった方法だけ記載しておきます…。よかったらヒントにしてください。 コードは改版自由で販売していま
mh-story.sakura.ne.jp

Twitter Api v2のOAuth 1.0aとOAuth 2.0の違い【X API】

OAuth 2.0でどのアクセストクーンが必要か?

最新の情報はこちらを見た方がよさそうです。

OAuth 2.0に完全移行すると、一部APIキーがいらなくなりますかね。

How to get access to the X API - X
docs.x.com

複数の情報源から次のように読み解きました。

キー名用途・役割v1.1 (OAuth 1.0a)での使用v2 (OAuth 2.0)での使用備考
Consumer API Keyアプリケーションの識別。リクエストの署名に利用必須（ユーザー認証やリクエスト署名に使用）不要v2では Client ID に置き換えられる
Consumer API Secretアプリケーション認証用の秘密鍵必須（署名に使用）不要v2では Client Secret が使用される
Client IDOAuth 2.0認証におけるアプリ識別―必須OAuth 2.0 PKCEフローでユーザーアクセストークン取得に利用
Client SecretOAuth 2.0認証でのアプリ認証用秘密鍵―必要（※confidentialクライアントの場合）パブリッククライアントの場合は不要な場合もある
Bearer Tokenアプリ単独認証用トークン（App-only認証）読み取り専用エンドポイントで利用可能ユーザー操作には不要
※読み取り専用の場合は利用可能		ユーザーの投稿などには、動的に発行されるユーザーアクセストークンを使用
Access Tokenユーザー認証の証明（ユーザー操作用）必須不要OAuth 2.0 PKCEでは動的に取得されるため固定トークンは発行されない
Access Token SecretAccess Token と対になる秘密鍵必須不要OAuth 2.0ではリクエスト署名に秘密鍵が不要

Bearer Token（ベアラートークン）は必要か？

Bearer Tokenはリファレンスをみると読み取り専用のことはすぐわかります。

This method is for developers that just need read-only access to public information. 

https://docs.x.com/resources/fundamentals/authentication/oauth-2-0/application-only

そして、少し意味が読みとりにくいかもしれませんが、次の文章で補足されています。

Please note that only OAuth 1.0a or OAuth 2.0 Authorization Code Flow with PKCE is required to issues requests on behalf of users. The API reference page describes the authentication method required to use an API. You will need user-authentication, user-context, with an access token to perform the following:

Post Tweets or other resources

https://docs.x.com/resources/fundamentals/authentication/oauth-2-0/application-only

こちらは文脈から判断するとBearer Tokenではなく、OAuth 2.0を使いましょうと案内されています。つまり、OAuth 2.0のClient IDと Client Secretを使いましょうと文章をよみとけます。OAuth 1.0aも触れられていますが、今から採用するのは古いため避けるべきでしょう。

「user-context(ユーザーコンテキスト)」はユーザーの代わりに行動する意味。簡単にいえば「ユーザー操作」と理解でもいいでしょう。

No user-context

When issuing requests using application-only auth, there is no concept of a “current user”. Therefore, endpoints such as POST statuses/update will not function with application-only auth. See using OAuth for more information for issuing requests on behalf of a user.

そしてBearer TokenはNo user-context。「現在のユーザー」という概念はありませんと明示しています。

Bearer Token（ベアラートークン）はApplication-only authentication（アプリケーション専用認証）の一部として使用され、主に公開情報の取得に使われます。たとえば、一般的な検索や公開ツイートの取得などに使用されます。 書き込み専用のアプリにはいらないですが、そのような拡張をする場合や仕様変更に備えてAPIキーは全部いれておく方が安全策という気がします。逆にしばらく使う予定がなければ外せばいいでしょう。

Access TokenとAccess Token Secret

Access TokenとAccess Token Secretは、OAuth 1.0aの認証に必要。V2はいりません。 OAuth 1.0aを使うとTwitter API1.1を利用できて、メディアのアップロードで画像投稿ができます! 今はメディアのアップロード以外で使いません!

OAuth 2.0でいらなくなるコードたち

まずはこれでしょう。

//----------------------------------------------------------------------'
// X API V1の基本処理(画像投稿、ツリー投稿用)
//----------------------------------------------------------------------'

function getService1() {
  debugLog('getService1')

  const scriptProps = PropertiesService.getScriptProperties();
  const TWITTER_CONSUMER_API_KEY = scriptProps.getProperty('TWITTER_CONSUMER_API_KEY');
  const TWITTER_CONSUMER_API_SECRET = scriptProps.getProperty('TWITTER_CONSUMER_API_SECRET');
  const TWITTER_ACCESS_TOKEN = scriptProps.getProperty('TWITTER_ACCESS_TOKEN');
  const TWITTER_ACCESS_TOKEN_SECRET = scriptProps.getProperty('TWITTER_ACCESS_TOKEN_SECRET');

  const service = OAuth1.createService('twitter1')
    .setAccessTokenUrl('https://api.twitter.com/oauth/access_token')
    .setRequestTokenUrl('https://api.twitter.com/oauth/request_token')
    .setAuthorizationUrl('https://api.twitter.com/oauth/authorize')
    .setConsumerKey( TWITTER_CONSUMER_API_KEY )
    .setConsumerSecret( TWITTER_CONSUMER_API_SECRET )
    .setAccessToken( TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_TOKEN_SECRET )
    .setCallbackFunction('authCallback')
    // .setPropertyStore(PropertiesService.getUserProperties());

  return service
}

こちらも工夫次第で外せますね。

function pkceChallengeVerifier() {
  debugLog('pkceChallengeVerifier')
  var userProps = PropertiesService.getUserProperties();
  if (!userProps.getProperty('code_verifier')) {
    var verifier = '';
    var possible = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~';

    for (var i = 0; i < 128; i++) {
      verifier += possible.charAt(Math.floor(Math.random() * possible.length));
    }

    var sha256Hash = Utilities.computeDigest(Utilities.DigestAlgorithm.SHA_256, verifier)

    var challenge = Utilities.base64Encode(sha256Hash)
      .replace(/\+/g, '-')
      .replace(/\//g, '_')
      .replace(/=+$/, '')
    userProps.setProperty('code_verifier', verifier)
    userProps.setProperty('code_challenge', challenge)
  }
}
// pkceChallengeVerifier(); // .generateCodeVerifier()を使用するため不要

return OAuth2.createService('twitter')
  .setAuthorizationBaseUrl("https://x.com/i/oauth2/authorize")
  .setTokenUrl("https://api.x.com/2/oauth2/token")
  // .setParam('grant_type','authorization_code')  // .generateCodeVerifier()を使用するため不要
  // .setParam('code_verifier', userProps.getProperty('code_verifier')) // .generateCodeVerifier()を使用するため不要
  .setClientId(TWITTER_CLIENT_ID)
  .setClientSecret(TWITTER_CLIENT_SECRET)
  .setRedirectUri(REDIRECT_URI)
  .setCallbackFunction('auth2Callback')
  .setPropertyStore(PropertiesService.getUserProperties())
  .setScope("tweet.write tweet.read media.write users.read offline.access")
  .generateCodeVerifier() // code_verifierとcode_challengeを自動生成・管理
  .setTokenHeaders({
    'Authorization': 'Basic ' + Utilities.base64Encode(TWITTER_CLIENT_ID + ':' + TWITTER_CLIENT_SECRET),
    'Content-Type': 'application/x-www-form-urlencoded'
  })
  // .setParam('response_type', 'code')
  // .setParam('code_challenge_method', 'S256') // .generateCodeVerifier()を使用するため不要
  // .setParam('code_challenge', userProps.getProperty('code_challenge')) // .generateCodeVerifier()を使用するため不要

シンプルにできるはず。

  // const twitterKeys = [
  //   'TWITTER_CONSUMER_API_KEY',
  //   'TWITTER_CONSUMER_API_SECRET',
  //   'TWITTER_CLIENT_ID',
  //   'TWITTER_CLIENT_SECRET',
  //   'TWITTER_BEARER_TOKEN',
  //   'TWITTER_ACCESS_TOKEN',
  //   'TWITTER_ACCESS_TOKEN_SECRET'
  // ];

  const twitterKeys = [
    'TWITTER_CLIENT_ID',
    'TWITTER_CLIENT_SECRET',
  ];

X(Twitter)の予約投稿ツールを開発しています。次のリンクから。

スプレッドシートで予約投稿するTwitter BOTツール: Craft Twix

以下は昔の申請方法です。参考程度に残しておきます。

Twitter APIのエラー【X API】

api.x.com/2/tweetsのエラー

念の為、テストしましたが、今だエンドポイントはapi.twitter.comですね。api.x.com/では動作しません。2025年3月時点。

// const TWITTER_API_ENDPOINT2 = 'https://api.x.com/2/tweets';
const TWITTER_API_ENDPOINT2 = 'https://api.twitter.com/2/tweets';

When authenticating requests to the Twitter API v2 endpoints, you must use keys and tokens from a Twitter developer App that is attached to a Project

先日まで動いていたのに突然動かなくなりました。。

When authenticating requests to the Twitter API v2 endpoints, you must use keys and tokens from a Twitter developer App that is attached to a Project

Twitterで同じような人がいました。

Standalone App に変更されているよう。何ゆえ？

Add app > Add an existing App > アプリを選ぶ > next

でなおったけど、ちょっと怖いなあ。ただのTwitter社のミスかなあ。審査をはじめるとか、Twitter APIの仕様の改悪はなしで…お願いしますよ。。

新規作成!電話番号が追加できない

(追記)今は電話番号なしにいけるようです。前に作ったとき、トラブルがありました。だからわかりませんが、辞めたのでしょうか。一応、覚書程度に残しておきます。

新規で作る場合は登録作業がいるようです。

Sign up for Free Account 

Sign up for Free Account がクリックできない場合は電話番号の登録が事前に必要です。

しかし、電話番号を追加しようとするとエラーになりますね。普通にTwitterのアカウントからいっても一緒です。

設定サポート > 設定プライバシー > アカウント > アカウント情報 >電話番号

一時のものなのでしょうか。

エラー

問題が発生しました。しばらくしてからやりなおしてください。

しょうがないので、すでにアプリ追加済の既存のアカウントから調整することにしました。プログラミングのテストをしたかっただけなので、どのアカウントでもよかったのです。

コメント

タイトルとURLをコピーしました