Filtered stream 移行概要
エンドポイント、演算子、ルール、認証要件をマッピングして、Standard v1.1 または PowerTrack から X API v2 へ Filtered stream の consumer を移行します。
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
エンドポイント、演算子、ルール、認証要件をマッピングして、Standard v1.1 または PowerTrack から X API v2 へ Filtered stream の consumer を移行します。
| Description | Standard v1.1 | PowerTrack API | X API v2 |
|---|---|---|---|
| アクセス | X App | Enterprise 契約とアカウントが必要 | 開発者アカウント(登録)、および Project 内の X App が必要 |
| :--- | :--- | :--- | :--- |
| Host domain | https://stream.x.com | https://gnip-stream.x.com | https://api.x.com |
| Endpoint path | 1.1/statuses/filter.json | /stream/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter//validation.json | /2/tweets/search/stream /2/tweets/search/stream/rules |
| 認証 | OAuth 1.0a User Context | HTTP Basic Authentication | OAuth 2.0 App-Only |
| サポートする HTTP メソッド | POST | GET POST | GET POST |
| 必須パラメーター | 接続時にパラメーターとしてルールを定義。以下のうち少なくとも 1 つ: * follow * track * locations | ストリーミング接続に必須パラメーターなし、オプションで backfill パラメーター。 ルールは個別に管理 | ストリーミング接続に必須パラメーターなし。レスポンス形式を定義するオプションパラメーターと、Academic Research アクセスのバックフィルリカバリ機能を追加可能。 ルールは個別に管理 |
| 配信タイプ | Streaming | Streaming REST(ルール管理用) | Streaming REST(ルール管理用) |
| デフォルトのリクエストレート制限 | 5 分あたり 5 回の接続試行 | POST と GET の両方のリクエストを合算して 1 分あたり 60 リクエスト /rules: 1 分あたり 60 リクエスト。特定ストリームの API に対する /rules エンドポイントへのすべてのリクエスト(POST と GET)で合算。 | エンドポイントによる。現在の上限はレート制限を参照。 |
| 最大許容接続数 | 認可済みユーザーあたり同時 2 | 契約により決定、複数/冗長接続をサポート | Pay-per-use: 1 |
| リカバリと冗長性機能 | なし | Backfill、冗長接続、Replay API | |
| Keep-alive シグナル / ハートビート | 少なくとも 20 秒ごとに空行 (\r\n など) | 10 秒ごとに空行 (\r\n など) | 少なくとも 20 秒ごとに空行 (\r\n など) |
| レイテンシ | 10 秒 | 2 秒 URL アンワインディングエンリッチメント使用時は少なくとも 10 秒 | 10 秒 |
| 最大許容ルール数 | 1 ルール(エンドポイント接続リクエスト内) | 契約により決定、最大 250,000 | Pay-per-use: 1,000 ルール |
| ルールフィルターの制限 | 接続あたり 1 クエリ、最大で以下のいずれか: - 400 の track キーワード - 5000 の follow ユーザー ID - 25 の location box | ルールあたり最大 2,048 文字 | Pay-per-use: ルールあたり 1,024 文字 |
| Post JSON フォーマット | Standard v1.1 フォーマット | Native Enriched または Activity Streams(コンソールで選択) | X API v2 フォーマット(fields および expansions リクエストパラメーターで決定、v1.1 フォーマットとは後方互換性なし) Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法については、データフォーマット移行ガイドを参照してください。Native Enriched と Activity Streams のデータフォーマット移行ガイドは近日中に公開予定です。 |
| 投稿の編集履歴とメタデータを提供 | ✔ | ✔ | ✔ |
| 独自の機能 | 接続リクエストのクエリパラメーターでフィルタリング 設定 UI なし | 独立したエンドポイントで作成したルールでフィルタリング 契約で利用可能なエンリッチメント機能 console.gnip.com UI での設定 | 独立したエンドポイントで作成したルールでフィルタリング メトリクスと URL エンリッチメント機能を含む オブジェクトの fields と expansions をリクエストパラメーターで指定 Post Annotations Conversation ID 演算子とフィールド Developer Console で設定 |