リストのメンバーを管理

このガイドでは、リストのメンバーを追加・削除する方法を説明します。

前提条件作業を始める前に、次のものが必要です。

承認済みの App を持つ開発者アカウント
User Access Token (OAuth 1.0a または OAuth 2.0 PKCE)
あなたが所有しているリスト

リストにメンバーを追加する

リストIDとユーザーIDを取得する

追加したいユーザーのユーザーIDと、対象のリストのIDが必要です。ユーザーIDはuser lookup endpointを使用して取得できます。

メンバーを追加する

cURL

curl -X POST "https://api.x.com/2/lists/1441162269824405510/members" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "2244994945"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# リストにメンバーを追加する
response = client.lists.add_member(
    list_id="1441162269824405510",
    user_id="2244994945"
)

print(f"Is member: {response.data.is_member}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// リストにメンバーを追加する
const response = await client.lists.addMember("1441162269824405510", {
  userId: "2244994945",
});

console.log(`Is member: ${response.data?.is_member}`);

レスポンスを確認する

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

リストからメンバーを削除する

cURL

curl -X DELETE "https://api.x.com/2/lists/1441162269824405510/members/2244994945" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# リストからメンバーを削除する
response = client.lists.remove_member(
    list_id="1441162269824405510",
    user_id="2244994945"
)

print(f"Is member: {response.data.is_member}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// リストからメンバーを削除する
const response = await client.lists.removeMember(
  "1441162269824405510",
  "2244994945"
);

console.log(`Is member: ${response.data?.is_member}`);

レスポンス:

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

重要な注意事項

メンバーを管理できるのは、自分が所有しているリストのみです
ユーザーをリストに追加する際に、そのユーザーの許可は必要ありません
ユーザーは、自分がどの公開リストに追加されたかを確認できます

次のステップ

リストメンバーの取得

リストメンバーを取得する

リストの管理

リストを作成および更新する

APIリファレンス

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

概要

投稿

ユーザー

ダイレクトメッセージ

いいね

リスト

スペース

コミュニティ

コミュニティノート

トレンド

ニュース

メディア

X のアクティビティ

利用状況

ストリーム接続

コンプライアンス

Enterprise v2

いいねのストリーム

GNIP 2.0

リストのメンバーを管理

リストにメンバーを追加する

リストからメンバーを削除する

重要な注意事項

次のステップ

リストメンバーの取得

リストの管理

APIリファレンス

​リストにメンバーを追加する

​リストからメンバーを削除する

​重要な注意事項

​次のステップ

リストメンバーの取得

リストの管理

APIリファレンス

リストにメンバーを追加する

リストからメンバーを削除する

重要な注意事項

次のステップ