リストメンバーの管理

​

リストメンバー管理クイックスタートガイド

注意: このガイドは、クイックスタート概要に記載の前提条件を完了していることを想定しています。

​

Listメンバー管理リクエストを作成する手順

​

ステップ1：Postman で List エンドポイントのコレクションを選択する

Postman に X API v2 のコレクションを読み込んだら、「List」フォルダーに移動し、「List members」フォルダーを選択してから「Add a member」を選びます。  

​

ステップ2：追加するユーザーを指定する

List メンバー管理エンドポイントには 2 つの ID が必要です。List の ID と、追加するユーザーの ID です。users lookup を使用してユーザーの ID を取得できます。ユーザー名を指定すると、id フィールドが返されます。

ターゲット ID は有効なユーザー ID であればいずれでも構いません。Postman で「Params」タブに移動し、id パス変数の「Value」列に自分の ID を入力します。続いて「Body」タブに移動し、追加したいユーザーの ID を user_id パラメータの値として入力します。ID の前後にスペースを入れないよう注意してください。

Key	Value	Parameter type
id	List の ID	path
user_id	メンバーとして追加したい対象ユーザーの ID	body

これで「Send」ボタンの横に次のような URL が表示されるはずです：

https://api.x.com/2/lists/1441162269824405510/members

ステップ3：リクエストを送信し、レスポンスを確認する

準備が整ったら「Send」ボタンを押すと、次の例と同様のレスポンスが返ってきます。

{
  "data": {
    "is_member": true
  }
}

返されたレスポンスオブジェクトでキー is_member の値が true であれば、ユーザーはそのリストのメンバーとして正常に追加されています。 

リストからメンバーを削除するには、Postman に読み込んだ X API v2 コレクションの「Lists」フォルダーにある「Remove a member」リクエストを選択します。このエンドポイントには、リストの ID と削除したいメンバーのユーザー ID が必要です。「Params」タブで、id 列にはリストの ID を、user_id 列には削除対象のユーザーの ID を入力します。 

削除リクエストが成功すると、次の例のようなレスポンスが返されます。

{
  "data": {
    "is_member": false
  }
}