メインコンテンツへスキップ
This initial release of Direct Messages lookup includes three GET methods:
  • GET /2/dm_conversations/with/:participant_id/dm_events - 1対1の会話に関連するダイレクトメッセージイベントを取得します。:participant_id パスパラメータは、このリクエストを行う認証済みユーザーと会話しているアカウントのユーザーIDです。
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - :dm_conversation_id パスパラメータで指定された特定の会話IDに関連するダイレクトメッセージイベントを取得します。
  • GET /2/dm_events - 1対1およびグループ会話の両方を含む、特定ユーザーに関連するダイレクトメッセージイベントを取得します。最大30日前までのイベントが利用可能です。
ダイレクトメッセージのイベントIDは v1.1 と v2（および X App）で共通のため、単一イベントを一覧表示する v1.1 のメソッドは、これらの新しい v2 endpoint と併用できます。なお、Enterprise および Premium の Account Activity API は v2 の1対1メッセージをサポートしていますが、グループ会話はまだサポートしていません。 このリリースでは3つのイベント type をサポートしており、これらの endpoint はそれらを絞り込むための query パラメータに対応しています:
  • MessageCreate - メッセージが作成されました。
  • ParticipantsJoin - 新しい参加者が会話に参加しました。
  • ParticipantsLeave - 参加者が会話から退出しました。
GET メソッドには、15分あたり300リクエストのユーザー レートリミットがあります。このレートリミットは、これらの GET endpoint 間で共有されます。 ダイレクトメッセージの v2 endpoint を使用してユーザーに代わってリクエストを行うため、OAuth 1.0a User Context または OAuth 2.0 Authorization Code with PKCE で認証し、あなたの X App を承認したユーザーに紐づく Access Tokens を使用する必要があります。OAuth 1.0a でこれらの Access Tokens を生成するには、3-legged OAuth フローを使用できます。OAuth 2.0 でユーザーの Access Tokens を生成するには、Authorization Code with PKCE grant flowを使用できます。 アカウント設定 これらの endpoint にアクセスするには、次が必要です: X API v2 endpoint へのアクセス方法の詳細は、getting started guideをご覧ください。
⌘I