Amazon Pinpoint で使用する Postman をセットアップする

ワークスペースの作成

Postman で、その他のアクションを選択し、[ファイル]、[新規] の順に選択します。

1. [新規作成] ウィンドウで [ワークスペース] を選択します。

2. 名前と概要を入力し、[可視性] を [個人] に設定します。次に、[ワークスペースの作成] を選択します。

環境を作成するには

1. Postman で、その他のアクションメニューを選択し、[ファイル]、[新規] の順に選択します。

2. [新規作成] ウィンドウで、[環境] を選択します。

3. [MANAGE ENVIRONMENTS] ウィンドウで、[環境名] に「Amazon Pinpoint - Region Name」と入力します。Region Name を次のいずれかのリージョンに置き換えます。

   • 米国東部 (バージニア北部)

   • 米国西部 (オレゴン)

   • アジアパシフィック (ムンバイ)

   • アジアパシフィック (シドニー)

   • 欧州 (フランクフルト)

   • 欧州 (アイルランド)

   注記

   少なくとも、1 つの AWS リージョン に環境を 1 つ作成する必要があり、その AWS リージョン には 1 つのプロジェクトが含まれていなければなりません。前述の AWS リージョン のいずれかでプロジェクトを作成していない場合は、「Amazon Pinpoint ユーザーガイド」の「E メールをサポートする Amazon Pinpoint プロジェクトの作成」を参照してください。

4. 6 つの新しい変数、endpoint、region、serviceName、accountId、accessKey、および secretAccessKey を作成します。次の表を使用して、各変数の [初期値] 列と [現在の値] に入力する値を決定します。

   リージョン	変数	初期値と現在の値
   米国東部 (バージニア北部)	endpoint	pinpoint.us-east-1.amazonaws.com
   	region	us-east-1
   	serviceName	mobiletargeting
   	accountId	(お客様の AWS アカウント ID)
   	accessKey	(お客様の IAM アクセスキー ID)
   	secretAccessKey	(お客様の IAM シークレットアクセスキー)
   米国西部 (オレゴン)	endpoint	pinpoint.us-west-2.amazonaws.com
   	region	us-west-2
   	serviceName	mobiletargeting
   	accountId	(お客様の AWS アカウント ID)
   	accessKey	(お客様の IAM アクセスキー ID)
   	secretAccessKey	(お客様の IAM シークレットアクセスキー)
   アジアパシフィック (ムンバイ)	endpoint	pinpoint.ap-south-1.amazonaws.com
   	region	ap-south-1
   	serviceName	mobiletargeting
   	accountId	(お客様の AWS アカウント ID)
   	accessKey	(お客様の IAM アクセスキー ID)
   	secretAccessKey	(お客様の IAM シークレットアクセスキー)
   アジアパシフィック (シドニー)	endpoint	pinpoint.ap-southeast-2.amazonaws.com
   	region	ap-southeast-2
   	serviceName	mobiletargeting
   	accountId	(お客様の AWS アカウント ID)
   	accessKey	(お客様の IAM アクセスキー ID)
   	secretAccessKey	(お客様の IAM シークレットアクセスキー)
   欧州 (フランクフルト)	endpoint	pinpoint.eu-central-1.amazonaws.com
   	region	eu-central-1
   	serviceName	mobiletargeting
   	accountId	(お客様の AWS アカウント ID)
   	accessKey	(お客様の IAM アクセスキー ID)
   	secretAccessKey	(お客様の IAM シークレットアクセスキー)
   欧州 (アイルランド)	endpoint	pinpoint.eu-west-1.amazonaws.com
   	region	eu-west-1
   	serviceName	mobiletargeting
   	accountId	(お客様の AWS アカウント ID)
   	accessKey	(お客様の IAM アクセスキー ID)
   	secretAccessKey	(お客様の IAM シークレットアクセスキー)

   これらの変数を作成すると、[MANAGE ENVIRONMENTS] ウィンドウは、次の図に示す例のようになります。

   

   完了したら、保存 を選択します。

   重要

   先ほどの画像に示されているアクセスキーは架空のものです。IAM アクセスキーは他のユーザーと共有してはいけません。

   Postman には、環境の共有とエクスポートのための機能があります。これらの機能を使用する場合、これらの認証情報にアクセスすべきではない人と、アクセスキー ID やシークレットアクセスキーを共有しないでください。

   詳細については、 『IAM ユーザーガイド』の「IAM ベストプラクティス」を参照してください。

5. (オプション) 作成する環境を追加するごとに、手順 1～4 を繰り返します。

   ヒント

   Postman では、必要な数だけ環境を作成することができます。環境は次の方法で使用できます。

   • Amazon Pinpoint API をテストする必要があるリージョンごとに個別の環境を作成します。

   • 異なる AWS アカウント アカウントに関連付けられた環境を作成します。

   • 他のユーザーに関連付けられている認証情報を使用する環境を作成します。

6. 環境の作成が完了したら、次のセクションに進みます。

Amazon Pinpoint コレクションを作成する

1. Postman で、その他のアクションメニューを選択し、[ファイル] を選択し、[インポート] を選択します。

2. [インポート] ウィンドウで、[Import From Link (リンクからインポート)] を選択し、URL https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json を入力します。

   [Import] (インポート) を選択します。Postman は、120 のサンプルリクエストが含まれている Amazon Pinpoint コレクションをインポートします。

Amazon Pinpoint コレクションの設定をテストするには

1. ナビゲーションペインで、[Collections] を選択し、Amazon Pinpoint コレクションを展開してから、Apps フォルダを展開します。

2. リクエストのリストで、[ GetApps] を選択します。

3. [環境] セレクタを使用して、「Postman 環境を作成する」で作成した環境を選択します。

4. [Send] を選択します。リクエストが正常に送信されると、[Response] ペインに 200 OK のステータスが表示されます。次のイメージの例のようなレスポンスが表示されます。

   

   注記

   AWS リージョン で作成されたプロジェクトがない場合は、Amazon Pinpoint で { "Item": [] } が返されます。

   このレスポンスには、「ステップ 3」で選択したリージョンにある自分のアカウントに存在するすべての Amazon Pinpoint プロジェクトの一覧が表示されます。