メインコンテンツへスキップ
このガイドでは、従来の Enterprise Account Activity API から V2 Account Activity API への移行方法を説明します。核となる機能は変わりませんが、X API v2 との一貫性を保つために、エンドポイントの構造と認証方式が更新されています。

​
変更点の概要

  • API 形式: エンドポイントのベースパスが /1.1/account_activity/ から /2/account_activity/ に変更されます。
  • Webhook 管理: Webhook の作成、一覧取得、検証（CRC）、削除は V2 Webhooks API によって処理されます。
  • 認証: V2 エンドポイントでは次のいずれかが必要です:
    • ユーザー単位のアクション（例: ユーザーを購読する）には OAuthUser（3-legged OAuth）。
    • アプリケーションレベルのアクション（例: 購読の一覧取得／削除）には OAuth2 App Only（ベアラートークン）。
    • V1.1 では要件がさまざまで、多くの場合 OAuth 1.0a が使用されていました。
  • エンドポイント対応表:
V1.1 EndpointV2 Equivalent / ActionNotes
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooksDocs。OAuth2AppOnly が必要です。
GET /1.1/account_activity/webhooks.jsonGET /2/webhooksDocs。OAuth2AppOnly が必要です。
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_idCRC をトリガーします。Docs。OAuth2AppOnly が必要です。
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_idDocs。OAuth2AppOnly が必要です。
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonPOST /2/account_activity/webhooks/:webhook_id/subscriptions/allOAuthUser が必要です。
GET /1.1/account_activity/subscriptions/count.jsonGET /2/account_activity/subscriptions/countOAuth2AppOnly が必要です。
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/allOAuthUser が必要です。
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all/listOAuth2AppOnly が必要です。
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allOAuth2AppOnly が必要です。
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/allDeprecated / No Direct Equivalent個別に削除するか、DELETE /2/webhooks/:webhook_id によって webhook を削除してください。
  • レスポンス形式: AAAPI ドキュメントで、成功およびエラーレスポンスの構造を確認してください。
移行時には、新しいベースパスを使用するようにコードを更新し、認証フローを調整し、V2 Webhooks API を使用して webhook を管理してください。

​
移行方法

  • パッケージを決定する:
    • Account Activity API へのアクセス用に Enterprise か Self-serve のパッケージを選択し、次の点を検討してください:
      • 必要な webhook の数。
      • 現在および将来見込みのサブスクリプション数／認可ユーザー数。
      • X クライアントアプリケーションの数。
      • 希望するサポートレベル（フォーラムによるサポートか、マネージド Enterprise の 1:1 サポートか）。
      • 料金の詳細（Enterprise については営業担当にお問い合わせください）。
  • 認証を OAuth 2.0 に更新する:
    • 使用している X App に「Read, Write, and Access Direct Messages」の権限が付与されていることを確認します。
    • V2 エンドポイントでは OAuth 2.0 を使用するように更新します。スコープが変更された場合は、ユーザーを再認可してください。
    • 開発者コンソールを使用して次を管理します:
      • OAuth 2.0 Access Token。
      • Client ID と Client Secret。
  • Webhook を確認または再設定する:
  • サンプル App:
    • Simple webhook server
      • CRC チェックに応答し、POST イベントを受信して処理する方法を示す、単一の Python スクリプトです。
    • Account Activity API sample dashboard
      • bun.sh で記述された Web アプリで、webhook とサブスクリプションを管理し、アプリ内でライブイベントを直接受信できます。