メインコンテンツへスキップ

​
Posts カウント endpoint の統合方法

このページでは、最新または全アーカイブの Post カウント endpoint をシステムに統合する際に知っておくべき各種ツールと主要な概念について説明します。ページは次のセクションで構成されています。

​
便利なツール

主要な概念を見ていく前に、これらのendpointの機能をテストし始めるために、次のいずれかのツールまたはコードサンプルの利用をお勧めします。

​
コードサンプル

お好みのプログラミング言語で、これらのendpointをコードで使い始めたい方へ。GitHubページでは、出発点として使える各種コードサンプルを提供しており、Pythonクライアントも含まれています。

​
ライブラリ

導入の手助けとなる、数多くのコミュニティ製サードパーティライブラリをご活用ください。適切なバージョンタグを確認すれば、v2 のendpointに対応したライブラリを見つけられます。

​
Postman

Postman は、これらの endpoint をテストするのに適したツールです。各 Postman リクエストには、その endpoint で利用できるすべてのパラメータが含まれており、何が利用可能かをすばやく把握するのに役立ちます。Postman コレクションの詳細については、Using Postman ページをご覧ください。  

​
主要な概念

​
認証

すべての X API v2 の endpoint は、キーおよびトークンとしても知られる一連の認証情報による認証済みリクエストを必要とします。 この endpoint では OAuth 2.0 Bearer Token の使用が必須であり、つまり、リクエストを成功させるには Bearer Token を渡す必要があります。 Bearer Token は、開発者用 App 内で直接生成するか、POST oauth2/token endpoint を使用して生成できます。

​
developer portal、Projects、および 開発者用 App

X API v2 の任意の endpoint を利用するには、デベロッパーアカウントを保有し、そのアカウント内にProjectを設定し、その Project 内に開発者用 Appを作成している必要があります。その開発者用 App 内のキーおよびトークンは、recent Post counts の endpoint で利用できます。full-archive Post counts endpoint を使用する、あるいは高度な operator やより長い query を利用する場合は、Enterprise アクセスの承認が必要です。 詳細は Enterprise アクセスのセクションをご覧ください。

​
レートリミット

毎日、数千人の開発者が X API にリクエストを送信しています。リクエスト量を管理するため、レートリミット が各 endpoint に設定されており、App の代理または認証済みユーザーの代理で、各開発者が行えるリクエスト数を制限しています。 この endpoint は App レベルでレートリミットされています。つまり、使用している認証情報に基づいて識別される任意の App から、この endpoint に対して一定期間内に行えるリクエスト数には上限があります。 

​
クエリの作成

これらのendpointの主な機能は、単一の query を用いて Posts をフィルタリングし、配信されるカウントを算出する点にあります。これらの query は、メッセージのキーワード、ハッシュタグ、URL など、Post およびユーザーの属性にマッチするオペレーターで構成されます。オペレーターは、ブールロジックや丸括弧と組み合わせて query に組み立てることで、query のマッチング挙動をより細かく調整できます。 query の作成方法に関するガイドをご参照ください。 Recent Post のカウントでは next_token は返されません。つまり、粒度に関係なく、1 回の API 呼び出しで過去 7 日間の Post ボリュームを取得できます。 Full-archive の Post カウントでは、過去 30 日分の data を取得できます。30 日を超える data については、ページネーションに使用できる next_token が返され、追加の data を取得できます。 

​
Post数のqueryの作成

Post数のendpointは、GETリクエストで単一のqueryを受け取り、そのqueryに一致する過去のPost数のセットを返します。queryは、さまざまなPostの属性にマッチさせるためのオペレーターで構成されます。 

​
目次

⌘I