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

​
Likes 管理エンドポイントのはじめ方

このクイックスタートガイドでは、Postman を使用して Likes 管理エンドポイントへの最初のリクエストを送信する手順を説明します。 さまざまな言語でのサンプルコードをご覧になりたい場合は、GitHub の X API v2 sample code リポジトリをご参照ください。 

​
前提条件

このガイドを完了するには、次の手順に従って生成できるキーとトークン一式が必要です。
  1. 開発者アカウントに申し込み、承認を受けてください。
  2. 開発者ポータルでプロジェクトと、それに関連付けられた開発者アプリを作成します。
  3. アプリの「Keys and tokens」ページに移動し、API Keys、Access Tokens、Bearer Token をパスワードマネージャーに保存してください。

​
いいね管理リクエストを作成する手順

ステップ1：ツールまたはライブラリから始める このエンドポイントへリクエストを送る方法はいくつかありますが、ここでは手順を簡素化するために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください。
X API v2 を Postman に追加 Postman に X API v2 コレクションを読み込んだら、「Likes」フォルダに移動し、「Like a Post」を選択します。 ステップ2：リクエストを認証する このエンドポイントへのリクエストを成功させるには、OAuth 1.0a ユーザーコンテキストを使用する必要があります。そのためには、「X API v2」という名前の環境を選択し、以下のキーとトークンを Postman に追加して、initial value と current value の各 fields に次の変数を設定してください。
  • consumer_key：API Key
  • consumer_secret：API Key Secret
  • access_token：Access Token
  • token_secret：Access Token Secret  
ステップ3：いいねする Post を指定する いいね管理エンドポイントでは2つのIDが必要です。1つはユーザー（Post にいいねしたいユーザー）用、もう1つはユーザーがいいねまたは取り消しを行う対象の Post を表す Post ID です。 ユーザーのIDは認証ユーザーのIDと一致している必要があります。つまり、リクエストを認証する際には、そのユーザーIDに関連付けられたAccess Tokensを渡す必要があります。今回は、自分のユーザーに属するIDを指定できます。ID の確認方法は次の2通りです。
  1. user lookup by username エンドポイントでユーザー名を渡すと、id フィールドが返されます。
  2. Access Token の数値部分があなたのユーザーIDです。  
また、いいねしたい Post も指定する必要があります。x.com を開き、Post をクリックして URL を確認すると Post ID を見つけられます。たとえば、次の URL の Post ID は 1228393702244134912 です。 https://x.com/TwitterDev/status/1228393702244134912 Postman で「Params」タブに移動し、id パス変数の「Value」列にあなたの ID を入力します。「Body」タブに移動し、いいねしたい Post の ID を tweet_id パラメータの値として入力します。ID の前後にスペースを入れないでください。
KeyValue
id(あなたのユーザーID)
tweet_id(いいねしたい Post のID)
「Send」ボタンをクリックすると、関係のステータスを含むレスポンスオブジェクトが返されます。
  • 「liked」: true が返ってきた場合、その id は tweet_id に正常にいいねできています。  
ステップ4：リクエストを送信し、レスポンスを確認する すべての設定が完了したら、「Send」ボタンを押して、次のレスポンスを受け取ります。 
{
    "data": {
        "liked": true
    }
}
同じ Post の「いいね」を取り消す場合は、Postman の X API v2 コレクション内の「Likes」フォルダーにある「Unlike a Post」というリクエストを使用できます。id と tweet_id は前の例と同様に使用してください。Post の「いいね」を取り消す際は、JSON ボディを追加する必要はありません。id と tweet_id の必須クエリパラメーターを忘れずに指定してください。