ミュート管理

ミュートの管理：Standard v1.1 と X API v2 の比較

standard v1.1 の POST mutes/users/create と POST mutes/users/destroy エンドポイントを利用している場合、このガイドは、standard v1.1 と X API v2 におけるミュート管理エンドポイントの共通点と相違点を理解するための手助けとなることを目的としています。

共通点
- OAuth 1.0a ユーザーコンテキスト
相違点
- エンドポイント URL
- App および Project の要件
- HTTP メソッド
- リクエストパラメータ

共通点

OAuth 1.0a User Context 認証方法 両方のエンドポイントバージョンは OAuth 1.0a User Context をサポートします。したがって、以前に Standard v1.1 の manage mutes エンドポイントのいずれかを使用していた場合、X API v2 バージョンへ移行しても、同じ認証方法をそのまま利用できます。

相違点

エンドポイント URL

Standard v1.1 エンドポイント:
- POST https://api.x.com/1.1/mutes/users/create.json (ユーザーをミュート)
- POST https://api.x.com/1.1/mutes/users/destroy.json (ユーザーのミュート解除)
X API v2 エンドポイント:
- POST https://api.x.com/2/users/:id/muting (ユーザーをミュート)
- DELETE https://api.x.com/2/users/:source_user_id/muting/:target_user_id (ユーザーのミュート解除)

App と Project の要件 X API v2 エンドポイントでは、リクエストを認証する際に、Project に関連付けられている developer App の認証情報を使用する必要があります。すべての X API v1.1 エンドポイントでは、Project に関連付けられていない App、または Project に関連付けられている App のいずれかの認証情報を使用できます。 リクエストパラメータ 次の Standard v1.1 リクエストパラメータには、X API v2 における対応するパラメータがあります:

Standard v1.1	X API v2
user_id	target_user_id
screen_name	対応なし

Standard v1.1 のパラメータはクエリパラメータとして渡される一方で、X API v2 のパラメータはボディパラメータ (POST エンドポイントの場合) またはパスパラメータ (DELETE エンドポイントの場合) として渡される点に注意してください。また、Standard v1.1 エンドポイントを使用する場合、対象ユーザーをミュートするユーザーの id を指定する必要はありません。これは、OAuth 1.0a User Context で渡されるアクセストークンによって、どのユーザーがミュート／ミュート解除を実行しているかが判断されるためです。

コード例

ユーザーをミュートする (v2)

cURL

curl -X POST "https://api.x.com/2/users/123456789/muting" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

# OAuth 1.0a のユーザーコンテキスト認証が必要です
import requests
from requests_oauthlib import OAuth1

auth = OAuth1(
    "API_KEY", "API_SECRET",
    "ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)

url = "https://api.x.com/2/users/123456789/muting"
response = requests.post(url, auth=auth, json={"target_user_id": "2244994945"})
print(response.json())

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.users.mute(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Muting: {response.data.muting}")

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.users.mute("123456789", {
  targetUserId: "2244994945",
});
console.log(`Muting: ${response.data?.muting}`);

ユーザーのミュート解除 (v2)

cURL

curl -X DELETE "https://api.x.com/2/users/123456789/muting/2244994945" \
  -H "Authorization: OAuth ..."

# OAuth 1.0a のユーザーコンテキスト認証が必要です
import requests
from requests_oauthlib import OAuth1

auth = OAuth1(
    "API_KEY", "API_SECRET",
    "ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)

url = "https://api.x.com/2/users/123456789/muting/2244994945"
response = requests.delete(url, auth=auth)
print(response.json())

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.users.unmute(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Muting: {response.data.muting}")

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.users.unmute("123456789", "2244994945");
console.log(`Muting: ${response.data?.muting}`);

Getting Started

Fundamentals

Partners & Customers

Resources

ミュート管理

ミュートの管理：Standard v1.1 と X API v2 の比較

共通点

相違点

コード例

ユーザーをミュートする (v2)

ユーザーのミュート解除 (v2)

​ミュートの管理：Standard v1.1 と X API v2 の比較

​共通点

​相違点

​コード例

​ユーザーをミュートする (v2)

​ユーザーのミュート解除 (v2)

ミュートの管理：Standard v1.1 と X API v2 の比較

共通点

相違点

コード例

ユーザーをミュートする (v2)

ユーザーのミュート解除 (v2)