メインコンテンツへスキップ

List メンバーのルックアップ

Members lookup グループには 2 つの利用可能な endpoint があります。指定した List のメンバーの詳細を取得したり、特定のユーザーが所属している List を確認したりできます。これらの endpoint は、メンバーシップ情報に基づいて新しい List をキュレーションおよび整理する際に利用できます。 メンバーの詳細をルックアップする場合のレートリミットは 15 分あたり 900 リクエスト、ユーザーのメンバーシップをルックアップする場合の上限は 15 分あたり 75 リクエストです。 この endpoint へのリクエストを認証するには、OAuth 1.0a ユーザーコンテキストApp only、または OAuth 2.0 Authorization Code(PKCE 付き) を使用できます。   

List のメンバーを管理する

Manage List members の endpoint を使用すると、認証済みユーザーに代わって List にメンバーを追加・削除できます。これらの endpoint には POST と DELETE の 2 つのメソッドがあります。POST は List にメンバーを追加し、DELETE は List からメンバーを削除します。両 endpoint のユーザー単位のレートリミットは、15 分あたり 300 リクエストです。 List のメンバー数は 5,000 を超えることはできません。 これらの endpoint でユーザーに代わってリクエストを行うためには、OAuth 1.0a User Context または OAuth 2.0 Authorization Code with PKCE でユーザーを認証し、あなたの App を承認したユーザーに紐づくユーザーの Access Tokens を使用する必要があります。これらのトークンは、3-legged OAuth flow(OAuth 1.0a)または Authorization Code with PKCE grant flow(OAuth 2.0)で生成できます。
アカウントの設定これらの endpoint にアクセスするには、以下が必要です。X API v2 の endpoint へのアクセス方法の詳細は、はじめにガイドをご覧ください。
I