クイックスタート

このガイドでは、Post またはユーザーのコンプライアンス状態を確認するためのバッチコンプライアンスジョブの作成手順を説明します。

前提条件始める前に、次のものが必要です:

承認済みアプリを持つ開発者アカウント
アプリの Bearer Token

ジョブを作成

タイプ (tweets または users) を指定して新規コンプライアンスジョブを作成します:

cURL
Python

curl -X POST "https://api.x.com/2/compliance/jobs" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "tweets",
    "name": "my-compliance-job"
  }'

import requests

bearer_token = "YOUR_BEARER_TOKEN"

url = "https://api.x.com/2/compliance/jobs"
headers = {
    "Authorization": f"Bearer {bearer_token}",
    "Content-Type": "application/json"
}
payload = {
    "type": "tweets",
    "name": "my-compliance-job"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

レスポンス:

{
  "data": {
    "id": "1234567890",
    "type": "tweets",
    "name": "my-compliance-job",
    "status": "created",
    "upload_url": "https://storage.googleapis.com/...",
    "download_url": "https://storage.googleapis.com/...",
    "created_at": "2024-01-15T10:00:00.000Z"
  }
}

次のステップのために upload_url と download_url を保存してください。

データファイルを準備

1 行に 1 つの ID を含むテキストファイルを作成します:

ids.txt として保存します。

データをアップロード

提供された upload_url にファイルをアップロードします:

curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
  -H "Content-Type: text/plain" \
  --data-binary @ids.txt

ジョブステータスを確認

完了するまでジョブのステータスをポーリングします:

curl "https://api.x.com/2/compliance/jobs/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN"

ジョブステータス:

Status	説明
`created`	ジョブ作成済み、アップロード待ち
`in_progress`	データ処理中
`complete`	結果をダウンロード可能
`failed`	ジョブ失敗
`expired`	完了前にジョブが期限切れ

結果をダウンロード

ステータスが complete になったら、download_url からダウンロードします:

curl "DOWNLOAD_URL_FROM_RESPONSE" -o results.json

結果フォーマット (1 行 1 つの JSON オブジェクト):

{"id": "1234567890", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-12T08:30:00.000Z", "reason": "deleted"}
{"id": "1234567891", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-13T14:20:00.000Z", "reason": "suspended"}

コンプライアンスイベントがある ID のみが結果に表示されます。結果に含まれない ID は依然として有効です。

コンプライアンスアクション

Post コンプライアンスイベント

Action	Reason	説明
`delete`	`deleted`	Post が削除された
`delete`	`bounced`	Post がコンプライアンスチェックに失敗した
`delete`	`protected`	アカウントが非公開になった
`delete`	`suspended`	アカウントが凍結された
`delete`	`scrub_geo`	位置情報データが削除された

ユーザーコンプライアンスイベント

Action	Reason	説明
`delete`	`deleted`	アカウントが削除された
`delete`	`suspended`	アカウントが凍結された
`delete`	`protected`	アカウントが非公開になった
`delete`	`deactivated`	アカウントが無効化された

すべてのジョブを一覧表示

アプリのすべてのコンプライアンスジョブを取得します:

curl "https://api.x.com/2/compliance/jobs?type=tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"

次のステップ

統合ガイド

主要な概念とベストプラクティス

Compliance ストリーム

リアルタイムのコンプライアンスイベント

API リファレンス

完全なエンドポイントドキュメント

Getting Started

Products

Fundamentals

Partners & Customers

Resources

クイックスタート

コンプライアンスアクション

すべてのジョブを一覧表示

次のステップ

統合ガイド

Compliance ストリーム

API リファレンス

​コンプライアンスアクション

​すべてのジョブを一覧表示

​次のステップ

統合ガイド

Compliance ストリーム

API リファレンス

コンプライアンスアクション

すべてのジョブを一覧表示

次のステップ