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

hide replies endpointのはじめ方

このクイックスタート ガイドでは、Postman を使用して、hide replies endpoint への最初のリクエストを送信する方法を説明します。 各種言語のコードスニペットを確認したい場合は、hide replies API Reference ページをご覧ください。

前提条件

このガイドを完了するには、リクエストの認証に使用する一連のキーおよびトークンが必要です。以下の手順に従って、これらのキーおよびトークンを生成できます。
  • デベロッパーアカウントに登録し、承認を受けてください。
  • developer portal で Project を作成し、関連付けられた 開発者用 App を作成します。
  • App の「Keys and tokens」ページに移動して、必要なクレデンシャルを生成します。すべてのクレデンシャルは安全な場所に保管してください。

PUT /tweets/:id/hidden リクエストを構築する手順

ステップ1: ツールまたはライブラリから始める

この endpoint にリクエストを送る方法はいくつかあり、各種ツールやコード例、ライブラリを利用できますが、ここでは手順を簡潔にするために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください。 Postman に X API v2 コレクションを読み込んだら、hide replies endpoint に移動します。

ステップ2:リクエストを認証する

X API に正しくリクエストを送るには、権限があることを確認する必要があります。この endpoint で行う場合は、OAuth 1.0a ユーザーコンテキスト または OAuth 2.0 Authorization Code(PKCE 付き) のいずれかでリクエストを認証する必要があります。 この例では、OAuth 1.0a ユーザーコンテキストを使用します。 Postman にキーおよびトークン、具体的には API Key、API Secret Key、OAuth 1.0a ユーザー Access Token、OAuth 1.0a ユーザー Access Token Secret を追加してください。Postman 右上の環境ドロップダウンで「X API v2」という環境を選択し、“initial value” と “current value” の fields にキーおよびトークンを追加します(環境ドロップダウン横の目のアイコンをクリック)。 これらの変数は、正しく設定されていれば、リクエストの authorization タブに自動的に反映されます。  

ステップ3:非表示にする Post ID を見つける

hide replies endpoint は、認可されたユーザーに代わって返信を非表示または再表示できます。今回の例では、あなたのユーザープロフィールに紐づく Access Tokens を使用しているため、あなたが開始した会話に参加しているユーザーからの返信を非表示にできます。同様に、あなたの App を認可した別のユーザーの Access Tokens を使用している場合は、そのアカウントが開始した会話への返信をモデレートできます。 友人に Post へ返信してもらう(返信の非表示をテストしている旨を伝えてください)、またはテスト用アカウントからあなたのいずれかの Posts に返信します。その返信をクリックし、URL の数値部分をコピーします。これが非表示にする Post ID です。 ここでは、次の Post を参照します。この Post の ID は 1232720193182412800 です。 https://x.com/TwitterDev/status/1232720193182412800

ステップ4: Post を非表示にする

Postman で Hide replies フォルダを開き、Hide a reply を選択します。Params タブで、id フィールドの横に Post ID を貼り付けます(URL の :id を置き換える必要はありません)。「Send」をクリックすると、成功レスポンスが表示されます。 {"hidden":true}

ステップ5: Post の非表示を解除する

非表示にした Posts は X アプリ内の別タブに移動されます。Postman で Post の非表示を解除するには、Hide replies フォルダーを開き、Unhide a reply を選択します。Params タブで、前のステップで使用したのと同じ Post ID を id フィールドに貼り付けます。「Send」をクリックすると、成功のレスポンスが表示されます。 {"hidden":false} hidden フィールドは、その Post の非表示ステータスを表します。非表示ステータスが true の場合、その Post は非表示です。false の場合は、その Post は非表示ではありません。
I