【第41回】 Marketing Cloud REST API 超入門 Part.2 - 認証
今回の記事は、以下のシリーズの続きです。
このシリーズは、3 つのセクションに分かれています。今回は ② の記事となります。
① API 連携のインターフェース設定 ～ Talend API Tester のインストール
② 認証サーバーへ「アクセストークン」を要求
③ リソースサーバーへ「リクエスト」を送信
■ 認証サーバーへ「アクセストークン」を要求
前回の記事で以下の 3 つをメモしてもらったかと思います。今回はこれらを使用して、認証サーバーから「アクセストークン」を取得します。
・クライアント ID
・クライアントシークレット
・認証ベース URL
まず、Talend API Tester を開き、リクエストタブで、メソッドを「POST」に設定します。
次に、エンドポイント URL を入力します。Part.1 でメモした「認証ベース URL」を使用して、以下のように入力してください。
https://[認証ベース URL].auth.marketingcloudapis.com/v2/token
次に、ヘッダーの設定を行います。以下の内容を入力してください。
■ 左窓に：Content-Type
■ 右窓に：application/json
次に、リクエストボディに以下の内容を入力します。
{
"grant_type": "client_credentials",
"client_id": "*************************",
"client_secret": "*************************",
"account_id": "*********"
}■ grant_type は固定値です。「client_credentials」を入力します。
■ クライアント ID とクライアントシークレットは Part.1 の記事でメモした値を入力してください。
■ MID は Marketing Cloud の画面の右上にある「企業名」をクリックすると表示される 9 桁の企業コードです。
すべて入力したら、「送信」ボタンをクリックします。
リクエストが成功すると、ステータスコード「200 OK」と共にレスポンスが返ってきます。
画面を下にスクロールして、アクセストークンを確認し、これをコピーしてメモしてください。このトークンは、次回の「Part.3 リソースサーバーへリクエストを送信」で使用します。
アクセストークンの例は、以下のような形です。結構長いので注意してください。
eyJhbGciOiJIUzI1NiIsImtpZCI6IjQiLCJ2ZXIiOiIxIiwidHlwIjoiSldUIn0.eyJhY2Nlc3NfdG9rZW4iOiIyYUFnRWlIRmx2dE9hTXJaMlA5ZUREbWgiLCJjbGllbnRfaWQiOiJiNGZycXFiY253c2txM3phNzRzMXVlY2kiLCJlaWQiOjUyNjAwMzc1MCwic3RhY2tfa2V5IjoiUzEyIiwicGxhdGZvcm1fdmVyc2lvbiI6MiwiY2xpZW50X3R5cGUiOiJTZXJ2ZXJUb1NlcnZlciIsInBpZCI6NjkwfQ.Aoc1DES0flvSQ9HErDctzonfCrSoSNooXqrKDXR8_eE.ZH8skFNf_idFJrJXq78mK87gui7bxvxKC5vtTu2SeI-kgtGY4-jopnVXu6eiBSkF0XS7d1opcZ6D4oW3ca85s64jsijujkjm-BO5hApUpwVy6Hx51wE1exEyFABiMTTGHgj5f1IAFkMr1X9GcO2TLjt_RIkyv9ys7jcXu
注意：このアクセストークンには有効期限があり、18 分（1079 秒）です。期限が切れた場合は、再度トークンを取得する必要があります。
最後に、今回設定したリクエストを後で再利用できるように、名前を付けて保存します。
リクエスト名：「アクセストークン発行用」など、分かりやすい名前を付けましょう。初めて Talend API Tester を使用する場合は、保存用のディレクトリを作成してから保存します。
ディレクトリ作成後、保存用のパスが完成したら「保存」ボタンを押します。
以上となります。
作ったリクエストは必ず保存するようにして、自分が使いたい時にすぐに使用できるようにしておきましょう。
これで、「アクセストークン」の取得は完了です。
次回の記事では、「リソースサーバーへリクエストを送信」する方法について説明しますので、ぜひご覧ください。
今回は以上です。
