メインコンテンツへスキップX は、X API を用いて構築する開発者コミュニティを支援することを約束します。この取り組みの一環として、API を開発者にとってオープンかつ公平に保ち、X 上の人々にとって安全であり、X プラットフォーム全体にとって有益なものにすることを目指しています。開発者が X のコンテンツをオフラインで保存する場合、その data がユーザーの意図と X 上のコンテンツの最新状態を反映していることが極めて重要です。たとえば、X 上の誰かが Post やアカウントを削除したり、Post を非公開にしたり、Post から位置情報を消去した場合、その人の期待と意図を X と開発者の双方が尊重することが重要です。バッチコンプライアンスエンドポイントは、X Developer Agreement and Policy に準拠して X の data を維持するのに役立つ、開発者向けの簡便なツールです。
これらのバッチコンプライアンスエンドポイントを使用すると、Post またはユーザーの ID の大規模なデータセットをアップロードしてコンプライアンスステータスを取得し、どの data に対してアクションが必要かを判断して、データセットを準拠状態にできます。ご注意ください。バッチコンプライアンスエンドポイントの使用は前述のユースケースに限定され、その他の目的での使用は禁止され、違反があった場合は措置の対象となる場合があります。
通常、このエンドポイントを扱う際には 4 つのステップがあります:
-
コンプライアンスジョブを作成する
ジョブタイプを指定できます（値 tweets または users を使用して、アップロードしたいデータセットに Post ID かユーザー ID が含まれるかを示します）。ジョブタイプごとに同時実行できるジョブは常に 1 つです。
-
upload_url にデータセットをアップロードする
次に、提供された upload_url にデータセットをプレーンテキストファイルとしてアップロードします。ファイルの各行には単一の Post ID またはユーザー ID を含めてください。upload_url は 15 分で有効期限が切れます。
-
（任意）ジョブのステータスを確認する
コンプライアンスジョブのステータスを確認し、created、in_progress、failed、complete のいずれかであるかを確認できます。
-
結果をダウンロードする
ジョブが完了したら、download_url を使用して結果をダウンロードできます。download_url は（ジョブ作成時点から）1 週間で有効期限が切れます。
この結果には JSON オブジェクトの集合（1 行につき 1 オブジェクト）が含まれます。各オブジェクトには、Post ID、Post の作成日（日時で整理された Post を探すのに有用）、必要なアクション、コンプライアンスアクションの理由、ユーザーが凍結された日付が含まれます。
結果には次のコンプライアイベントタイプが含まれます:
- deleted - Post またはユーザーアカウントが削除されたことを示します
- deactivated - Post またはユーザーアカウントが無効化されたことを示します
- scrub_geo - Post またはユーザーに関連付けられた位置情報が削除されたことを示します
- protected - Post を作成したアカウントが非公開になったことを示します
- suspended - Post を作成したアカウントが凍結されたことを示します
アカウントのセットアップ
これらのエンドポイントにアクセスするには、以下が必要です:
X API v2 エンドポイントへのアクセス方法の詳細は、はじめにガイドをご覧ください。
