**サポート終了通知:** 2026 年 10 月 30 日に、 AWS は Amazon Pinpoint のサポートを終了します。2026 年 10 月 30 日を過ぎると、Amazon Pinpoint コンソールまたは Amazon Pinpoint のリソース (エンドポイント、セグメント、キャンペーン、ジャーニー、分析) にアクセスできなくなります。詳細については、「[Amazon Pinpoint のサポート終了](https://docs.aws.amazon.com/console/pinpoint/migration-guide)」を参照してください。**注:** SMS、音声、モバイルプッシュ、OTP、電話番号の検証に関連する APIs は、この変更の影響を受けず、 AWS エンドユーザーメッセージングでサポートされています。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # チュートリアル: Amazon Pinpoint API で Postman を使用する Postman は使いやすいグラフィカル環境で API をテストする、人気の高いツールです。Postman を使用して、API リクエストを任意の REST API へ送信し、リクエストに対する応答を受け取ることができます。Postman を使用するのは、Amazon Pinpoint API への呼び出しをテストおよびトラブルシューティングするのに便利な方法です。このチュートリアルには、Amazon Pinpoint で Postman を設定し、使用する手順が含まれています。 **注記** Postman は、サードパーティー企業によって開発されています。Amazon Web Services (AWS) が開発およびサポートするものではありません。Postman の使用方法または Postman に関連する問題のサポートの詳細については、Postman ウェブサイトで[サポートセンター](https://support.postman.com/hc/en-us)を参照してください。 ## このチュートリアルの内容 このセクションでは、このチュートリアルの概要について説明します。 **対象者** このチュートリアルは、開発者とシステム実装者を対象としています。このチュートリアルの手順を完了するために Amazon Pinpoint または Postman に精通している必要はありません。IAM ポリシーの管理および JSON のコード例の変更に慣れている必要があります。 このチュートリアルの手順は、新しいユーザーが、Amazon Pinpoint リソースを完全に削除する可能性のある API オペレーションを使用できないように設計されました。上級ユーザーは、 ユーザーに関連付けられているポリシーを変更して、この制限を解除できます。 **使用される機能** このチュートリアルには、次の Amazon Pinpoint 機能の使用例が含まれています。 + Postman を使用して Amazon Pinpoint APIと対話する **所要時間** このチュートリアルは完了までに約 15 分かかります。 **リージョン別制限** このソリューションの使用に関連するリージョン別制限はありません。 **リソース使用量のコスト** AWS アカウントの作成には料金はかかりません。ただし、このソリューションを実装することで、Postman を使用して次のいずれかを実行すると AWS 、使用コストが発生する可能性があります。 + E メール、SMS、モバイルプッシュ、または音声メッセージを送信する + キャンペーンを作成して送信する + 電話番号検証機能を使用する Amazon Pinpoint の使用に関連する料金の詳細については、「[Amazon Pinpoint pricing](https://aws.amazon.com/pinpoint/pricing/)」を参照してください。 # Postman を Amazon Pinpoint で使用するための前提条件 このチュートリアルを開始する前に、次の前提条件を完了してください。 + AWS アカウントが必要です。AWS アカウントを作成するには、[https://console.aws.amazon.com/](https://console.aws.amazon.com/)から、[**Create a new AWS account**] を選択します。 + AWS マネジメントコンソール へのサインインに使用するアカウントで新しい IAM ポリシーおよびロールを作成できることを確認します。 + 作成した少なくとも 1 つのサンプルプロジェクトで E メールが有効になっており、検証済みの E メール ID があることを確認します。「*Amazon Pinpoint ユーザーガイド*」の「[E メールをサポートする Amazon Pinpoint プロジェクトの作成](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html)」を参照してください。 + AWS アカウント ID を持っていることを確認します。AWS アカウント ID はコンソールの右上に表示されます。また、コマンドラインインターフェイス (CLI) を使用することもできます。「[AWS アカウント ID の検索](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)」を参照してください。 + Postman をコンピュータにダウンロードしてインストールする必要があります。Postman は、[Postman ウェブサイト](https://www.getpostman.com)からダウンロードできます。 + コンピュータに Postman をインストールしたら、Postman アカウントを作成します。Postman アプリケーションを最初に起動するときは、ログインするか、新しいアカウントを作成するように求められます。Postman の指示に従ってアカウントにログインします。まだアカウントを持っていない場合は作成します。 **Next**: [IAM ポリシーおよびロールを作成する](tutorials-using-postman-iam-user.md) # Amazon Pinpoint で使用する IAM ポリシーおよびロールを作成する Postman を使用して Amazon Pinpoint API をテストするとき、最初のステップはユーザーを作成することです。このセクションでは、すべての Amazon Pinpoint リソースの操作をユーザーに許可するポリシーを作成します。その後、ユーザーを作成し、そのユーザーにポリシーを直接アタッチします。 ## IAM ポリシーを作成する IAM ポリシーの作成方法について説明します。このポリシーを使用するユーザーとロールは、Amazon Pinpoint API ですべてのリソースを操作できます。また、Amazon Pinpoint Email API、Amazon Pinpoint SMS and Voice API に関連するリソースへのアクセスも提供します。 **ポリシーを作成するには** 1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) で IAM コンソールを開きます。 1. ナビゲーションペインで **ポリシー**を選択してから **ポリシーの作成**を選択します。 1. **[ポリシーエディター]** で、**[JSON]** を選択します。**[ポリシーエディター]** で現在の JSON を削除して、空白にします。次の JSON をコピーして **[ポリシーエディター]** に貼り付け、**[ポリシーエディター]** で *123456789012* のすべてのインスタンスを AWS アカウント ID に置き換えます。 AWS アカウント ID はコンソールの右上隅にあるか、CLI を使用できます。[AWS 「アカウント ID の検索](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)」を参照してください。 **注記** Amazon Pinpoint アカウント内のデータを保護するため、このポリシーには、リソースの読み取り、作成、変更ができるアクセス許可のみが含まれています。リソースの削除を許可するアクセス許可はこのポリシーに含まれていません。IAM コンソールのビジュアルエディタを使用してポリシーを変更できます。IAM ポリシーの詳細については、『IAM ユーザーガイド』の「[Managing IAM policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html)」を参照してください。また、IAM API の [CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html) オペレーションを使用して、このポリシーを更新できます。 また、このポリシーには、`mobiletargeting` サービスに加えて、`ses` サービスや `sms-voice` サービスを操作するためのアクセス許可も含まれています。`ses` および `sms-voice` のアクセス許可により、それぞれ Amazon Pinpoint Email API および Amazon Pinpoint SMS and Voice API を利用することができます。`mobiletargeting` アクセス許可では、Amazon Pinpoint API を操作することができます。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "mobiletargeting:Update*", "mobiletargeting:Get*", "mobiletargeting:Send*", "mobiletargeting:Put*", "mobiletargeting:Create*" ], "Resource": [ "arn:aws:mobiletargeting:*:123456789012:apps/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "mobiletargeting:TagResource", "mobiletargeting:PhoneNumberValidate", "mobiletargeting:ListTagsForResource", "mobiletargeting:CreateApp" ], "Resource": "arn:aws:mobiletargeting:*:123456789012:*" }, { "Sid": "VisualEditor2", "Effect": "Allow", "Action": [ "ses:TagResource", "ses:Send*", "ses:Create*", "ses:Get*", "ses:List*", "ses:Put*", "ses:Update*", "sms-voice:SendVoiceMessage", "sms-voice:List*", "sms-voice:Create*", "sms-voice:Get*", "sms-voice:Update*" ], "Resource": "*" } ] } ``` ------ [**次へ**] を選択します。 1. **[ポリシー名]** にポリシーの名前を入力します (例: **PostmanAccessPolicy**)。[**Create policy**] (ポリシーの作成) を選択します。 1. (オプション) ポリシーにタグを追加するには、**[タグの追加]** を選択します。 1. **[次へ: レビュー]** を選択します。 ## IAM ユーザーの作成 **警告** IAM ユーザーは長期認証情報を保有するため、セキュリティ上のリスクが生じます。このリスクを軽減するために、これらのユーザーにはタスクの実行に必要な権限のみを付与し、不要になったユーザーは削除することをお勧めします。 ポリシーを作成したら、ユーザーを作成してポリシーをアタッチできます。ユーザーを作成するとき、IAM では、Postman に Amazon Pinpoint API オペレーションの実行を許可する一連の認証情報が提供されます。 **ユーザーを作成するには** 1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。 1. IAM コンソールのナビゲーションペインで **[ユーザー]** を選択し、**[ユーザーを作成]** を選択します。 1. **[ユーザーの詳細]** の **[ユーザー名]** に、**PostmanUser** など、ユーザーを識別する名前を入力します。次いで、**[次へ]** を選択します。 1. **[許可を設定]** ページの **[許可のオプション]** で、**[ポリシーを直接アタッチする]** を選択します。 1. **[アクセス許可ポリシー]** で、「[IAM ポリシーを作成する](#tutorials-using-postman-iam-user-create-policy)」で作成したポリシー (**PostmanAccessPolicy**) を選択します。次いで、**[次へ]** を選択します。 1. **[確認して作成]** ページで、必要に応じて、ユーザーを識別するのに役立つタグを追加します。タグの使用に関する詳細については、「IAM ユーザーガイド」の「[IAM リソースのタグ付け](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html)」を参照してください。** 1. ユーザーを作成する準備ができたら、[**ユーザーの作成**] を選択します。 ## アクセスキーを作成する **警告** このシナリオでは、プログラムによるアクセスと長期的な認証情報を持つ IAM ユーザーが必要です。これはセキュリティ上のリスクをもたらします。このリスクを軽減するために、これらのユーザーにはタスクの実行に必要な権限のみを付与し、不要になったユーザーは削除することをお勧めします。アクセスキーは、必要に応じて更新できます。詳細については、「*IAM ユーザーガイド*」の「[アクセスキーの更新](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html)」を参照してください。 IAM では、Postman に Amazon Pinpoint API オペレーションの実行を許可するために使用できる一連の認証情報が提供されます。 **ユーザーを作成するには** 1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。 1. IAM コンソールのナビゲーションペインで **[ユーザー]** を選択します。「[IAM ユーザーを作成する](#tutorials-using-postman-iam-user-create-user)」で作成したユーザー (**PostmanUser**) を選択し、**[セキュリティ認証情報]** タブを選択します。 1. [**Access keys (アクセスキー)**] セクションで、[**Create access key (アクセスキーを作成)**] を選択します。 1. **[アクセスキーのベストプラクティスと代替案]** ページで、**[ AWSの外部で実行されるアプリケーション]** を選択します。 次いで、**[次へ]** を選択します。 1. (オプション) ポリシーには説明タグを追加できます。 1. **[アクセスキーを作成]** を選択します。 1. **[アクセスキーを取得]** ページで、**[アクセスキー]** 列と **[シークレットアクセスキー]** 列に表示されている認証情報をコピーします。 **注記** このチュートリアルの後半で、アクセスキー ID とシークレットアクセスキーの両方を入力する必要があります。シークレットアクセスキーを表示できるのは、このときのみとなります。コピーして安全な場所に保存することをお勧めします。 1. 両方のキーを保存したら、**[完了]** を選択します。 **Next**: [Postman をセットアップする](tutorials-using-postman-configuration.md) # Amazon Pinpoint で使用する Postman をセットアップする Amazon Pinpoint API にアクセスできるユーザーアカウントを作成したので、Postman をセットアップできます。このセクションでは、Postman で 1 つ以上の環境を作成します。次に、Amazon Pinpoint API の各オペレーションのリクエストテンプレートが含まれているコレクションをインポートします。 ## Postman ワークスペースを作成する Postman において、ワークスペースはプロジェクトと環境用の組織のコンテナです。**このセクションでは、Amazon Pinpoint で使用するワークスペースを少なくとも 1 つ作成します。 **ワークスペースの作成** Postman で、その他のアクションを選択し、**[ファイル]**、**[新規]** の順に選択します。 1. **[新規作成]** ウィンドウで **[ワークスペース]** を選択します。 1. 名前と概要を入力し、[可視性] を [個人] に設定します。次に、**[ワークスペースの作成]** を選択します。 ## Postman 環境を作成する Postman では、*環境*とは、キーと値のペアとして保存される一連の変数です。環境を使用すると、Postman を介してリクエストの設定を変更でき、API リクエスト自体を変更する必要はありません。 このセクションでは、Amazon Pinpoint で使用するには、少なくとも 1 つの環境を作成します。作成する各環境には、1 つの AWS リージョンのアカウントに固有の変数のセットが含まれています。このセクションの手順を使用して複数の環境を作成する場合、Postman で **[環境]** メニューから別の環境を選択して、リージョン間で変更できます。 **環境を作成する方法** 1. Postman で、その他のアクションメニューを選択し、**[ファイル]**、**[新規]** の順に選択します。 1. [**新規作成**] ウィンドウで、[**環境**] を選択します。 1. [**MANAGE ENVIRONMENTS**] ウィンドウで、[**環境名**] に「**Amazon Pinpoint - *Region Name***」と入力します。*Region Name* を次のいずれかのリージョンに置き換えます。 + 米国東部 (バージニア北部) + 米国西部 (オレゴン) + アジアパシフィック (ムンバイ) + アジアパシフィック (シドニー) + 欧州 (フランクフルト) + 欧州 (アイルランド) **注記** 少なくとも、1 つの に対して 1 つの環境を作成するだけで AWS リージョン、1 つのプロジェクトを含める AWS リージョン 必要があります。前述のいずれかの でプロジェクトを作成していない場合は AWS リージョン、[Amazon Pinpoint ユーザーガイド」の「E メールをサポートする Amazon Pinpoint プロジェクトの作成](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html)」を参照してください。 *Amazon Pinpoint * 1. 6 つの新しい変数、`endpoint`、`region`、`serviceName`、`accountId`、`accessKey`、および `secretAccessKey` を作成します。次の表を使用して、各変数の **[初期値]** 列と **[現在の値]** に入力する値を決定します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/userguide/tutorials-using-postman-configuration.html) これらの変数を作成すると、[**MANAGE ENVIRONMENTS**] ウィンドウは、次の図に示す例のようになります。 ![\[\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png) 完了したら、**保存** を選択します。 **重要** 先ほどの画像に示されているアクセスキーは架空のものです。IAM アクセスキーは他のユーザーと共有してはいけません。 Postman には、環境の共有とエクスポートのための機能があります。これらの機能を使用する場合、これらの認証情報にアクセスすべきではない人と、アクセスキー ID やシークレットアクセスキーを共有しないでください。 詳細については、 『*IAM ユーザーガイド*』の「[IAM ベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)」を参照してください。 1. (オプション) 作成する環境を追加するごとに、手順 1～4 を繰り返します。 **ヒント** Postman では、必要な数だけ環境を作成することができます。環境は次の方法で使用できます。 Amazon Pinpoint API をテストする必要があるリージョンごとに個別の環境を作成します。 異なる AWS アカウントアカウントに関連付けられた環境を作成します。 他のユーザーに関連付けられている認証情報を使用する環境を作成します。 1. 環境の作成が完了したら、次のセクションに進みます。 ## Postman で Amazon Pinpoint コレクションを作成する Postman では、*コレクション* は API リクエストのグループです。コレクション内のリクエストは通常、共通の目的で結合されます。このセクションでは、Amazon Pinpoint API での各オペレーションに対するリクエストテンプレートを含む新しいコレクションを作成します。 **Amazon Pinpoint コレクションを作成する** 1. Postman で、その他のアクションメニューを選択し、**[ファイル]** を選択し、**[インポート]** を選択します。 1. [**インポート**] ウィンドウで、[**Import From Link (リンクからインポート)**] を選択し、URL [https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman\$1collection.json](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json) を入力します。 [**インポート**] を選択します。Postman は、120 のサンプルリクエストが含まれている Amazon Pinpoint コレクションをインポートします。 ## Postman 設定のテスト Amazon Pinpoint コレクションをインポートした後、簡単なテストを実行して、すべてのコンポーネントが適切に設定されていることを検証することをお勧めします。`GetApps` リクエストを送信することで、設定をテストできます。このリクエストでは、現在の AWS リージョンで自分の Amazon Pinpoint アカウントに存在するすべてのプロジェクトのリストが返されます。このリクエストは、他に追加の設定を必要としないため、設定をテストする方法に適しています。 **Amazon Pinpoint コレクションの設定をテストするには** 1. ナビゲーションペインで、**[Collections]** を選択し、**Amazon Pinpoint** コレクションを展開してから、**Apps** フォルダを展開します。 1. リクエストのリストで、[ **GetApps**] を選択します。 1. **[環境]** セレクタを使用して、「[Postman 環境を作成する](#tutorials-using-postman-configuration-create-environments)」で作成した環境を選択します。 1. [**Send**] を選択します。リクエストが正常に送信されると、[Response] ペインに `200 OK` のステータスが表示されます。次のイメージの例のようなレスポンスが表示されます。 ![\[\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png) **注記** にプロジェクトが作成されていない場合 AWS リージョン 、Amazon Pinpoint は を返します`{ "Item": [] }`。 このレスポンスには、「ステップ 3」で選択したリージョンにある自分のアカウントに存在するすべての Amazon Pinpoint プロジェクトの一覧が表示されます。 ### トラブルシューティング リクエストを送信すると、エラーが表示される可能性があります。発生する可能性のあるいくつかの一般的なエラーと問題を解決するための手順については、以下のリストをご覧ください。 | エラーメッセージ | 問題 | 解決策 | | --- | --- | --- | | 何もレスポンスが得られませんでした https://%7B%7Bendpoint%7D%7D/v1/apps に接続中にエラーが発生しました。 | 環境を選択したときに設定される、`{{endpoint}}` 変数の現在の値がありません。 | 環境セレクタを使用して環境を選択します。 | | リクエストに含まれているセキュリティトークンが無効です。 | Postman では、アクセスキー ID またはシークレットアクセスキーの現在の値を見つけることができませんでした。 | 環境セレクタの近くにある歯車アイコンを選択し、現在の環境を選択します。`accessKey` および `secretAccessKey` の値が **[INITIAL VALUE]** と **[CURRENT VALUE]** の両方の列に表示されること、および認証情報が正しく入力されていることを確認します。 | | 「メッセージ」: "ユーザー: arn:aws:iam::123456789012:user/PinpointPostmanUser には、次の操作を実行する権限がありません: mobiletargeting:GetApps on resource: arn:aws:mobiletargeting:us-west-2:123456789012:\$1" | ユーザーに関連付けられている IAM ポリシーに、適切なアクセス許可が含まれていません。 | 「[IAM ポリシーを作成する](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)」で説明したアクセス許可がユーザーにあること、および「[Postman ワークスペースを作成する](#tutorials-using-postman-configuration-create-environments)」で環境を作成したときに適切な認証情報を指定したことを確認します。 | **Next**: [追加のリクエストを送信する](tutorials-using-postman-sample-requests.md) # Amazon Pinpoint API にリクエストを送信する Postman の設定とテストが完了したら、Amazon Pinpoint API に追加のリクエストの送信を開始することができます。このセクションには、リクエストの送信を開始する前に知っておく必要がある情報が記載されています。また、Amazon Pinpoint コレクションの使用方法の説明に役立つリクエスト例も 2 つ含まれています。 **重要** このセクションの手順を完了したら、Amazon Pinpoint API へのリクエストを送信します。これらのリクエストでは、Amazon Pinpoint アカウントでの新しいリソースの作成、既存のリソースの変更、メッセージの送信、Amazon Pinpoint プロジェクトの設定の変更、その他の Amazon Pinpoint 機能の使用を行います。これらのリクエストを実行するときには注意が必要です。 ## Amazon Pinpoint Postman コレクションの例 Amazon Pinpoint Postman コレクションのほとんどのオペレーションは、使用する前に設定する必要があります。`GET` と `DELETE` オペレーションの場合、通常は、[**Pre-request Script**] タブで設定されている変数を変更するだけです。 **注記** 「[IAM ポリシーを作成する](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)」で示した IAM ポリシーを使用する場合、このコレクションに含まれる `DELETE` リクエストを実行することはできません。 例えば、`GetCampaign` オペレーションでは、`projectId` と `campaignId` を指定する必要があります。[**Pre-request Script**] タブには、これら両方の変が存在し、値の例が設定されています。値の例を削除し、Amazon Pinpoint プロジェクトとキャンペーンに該当する値に置き換えます。 これらの変数のうち、最も一般的に使用されるのは `projectId` 変数です。この変数の値は、リクエストが適用されるプロジェクトの一意の識別子であることが必要です。プロジェクトの識別子のリストを取得するには、このチュートリアルの前のステップで送信した `GetApps` リクエストに対するレスポンスを参照してください。そのレスポンスで、`Id` フィールドにプロジェクトの一意の識別子が表示されています。`GetApps` オペレーションおよびレスポンスの各フィールドの意味の詳細については、「*Amazon Pinpoint APIリファレンス*」の「[Apps](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html)」を参照してください。 **注記** Amazon Pinpoint では、「プロジェクト」は「アプリ」や「アプリアプリケーション」と同じです。 `POST` オペレーションと `PUT` オペレーションの場合、リクエスト本文を変更して、API に送信する値が含まれるようにする必要もあります。例えば、`POST` リクエストである `CreateApp` リクエストを送信するときには、作成するプロジェクトの名前を指定する必要があります。[**本文**] タブで、リクエストを変更することができます。この例では、`"Name"` の横にある値をプロジェクトの名前に置き換えます。プロジェクトにタグを追加するには、`tags` オブジェクトで指定します。または、タグを追加しない場合は、`tags` オブジェクト全体を削除することができます。 **注記** `UntagResource` オペレーションでは、URL パラメータを指定する必要もあります。これらのパラメータは、[**Params**] タブで指定することができます。[**VALUE**] 列の値を、指定されたリソースについて削除するタグに置き換えます。 ## リクエストの例: `CreateApp` オペレーションを使用したプロジェクトを作成する Amazon Pinpoint でセグメントおよびキャンペーンを作成する前に、まずプロジェクトを作成する必要があります。Amazon Pinpoint では、*プロジェクト*は、セグメント、キャンペーン、設定、および共通の目的で結合されたデータで構成されます。例えば、特定のアプリケーション、または特定のブランドまたはマーケティングイニシアティブに関連するすべてのコンテンツを含むプロジェクトを使用できます。Amazon Pinpoint にお客様の情報を追加すると、その情報はプロジェクトに関連付けられます。 **CreateApp API リクエストを送信してプロジェクトを作成するには** 1. **環境**メニューで、プロジェクト AWS リージョン を作成する を選択します。 ![\[\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) この例では、[**環境**] メニューには次の 4 つのオプションが表示されるように Postman が設定されています。 + 米国東部 (バージニア北部) + 米国西部 (オレゴン) + 欧州 (フランクフルト) + 欧州 (アイルランド) 1. **[Apps]** フォルダで、**[CreateApp]** オペレーションを選択します。 ![\[\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) Amazon Pinpoint Postman コレクション内の **[Apps]** フォルダが展開され、次のリクエストが表示されます。 + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. [**本文**] タブの、`"Name"` の横にあるプレースホルダーの値 (`"string"`) を、**"MySampleProject"** など、キャンペーンの名前に置き換えます。 1. キャンペーン名の後ろにあるカンマを削除し、3～5 行目にある `tags` オブジェクト全体を削除します。終了すると、リクエストは次のコードスニペットの例のようになります。 ``` { "Name": "MySampleProject" } ``` Postman は未加工の JSON ペイロードとしてリクエストを送信するように設定されています。 1. **[送信]** を選択します。キャンペーンが正常に作成された場合、[レスポンス] ペインに `201 Created` のステータスが表示されます。 ``` { "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} } ``` ## 例: `SendMessages` オペレーションを使用して E メールを送信する トランザクションメッセージを送信するために Amazon Pinpoint `SendMessages` API を使用するのは非常に一般的です。キャンペーンを作成するのではなく、`SendMessages` API を使用してメッセージを送信する利点の 1 つは、E メールアドレス、電話番号、デバイストークンなど任意のアドレスにメッセージを送信できることです。メッセージの送信先のアドレスは、Amazon Pinpoint アカウント内に存在している必要はありません。この方法を、キャンペーンを作成してメッセージを送信する方法と比較してみましょう。Amazon Pinpoint でキャンペーンを送信する前に、Amazon Pinpoint アカウントにエンドポイントを追加し、セグメントを作成し、キャンペーンを作成し実行する必要があります。 このセクションの例は、特定の E メールアドレスに直接トランザクションメールメッセージを送信する方法を説明しています。このリクエストを変更して、SMS、モバイルプッシュ、または音声など、他のチャネル経由でメッセージを送信できます。 **SendMessages リクエストを送信して E メールメッセージを送信するには** 1. E メールチャネルがプロジェクトで有効になっており、メッセージの送受信に使用する E メールアドレスやドメインが設定されていることを確認します。詳細については、『Amazon Pinpoint ユーザーガイド』の「[E メールチャネルの有効化と無効化](pinpoint/latest/userguide/channels-email-setup.html)」と「[E メール ID の検証](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html)」を参照してください。** **注記** このセクションの手順を実行するには、E メールアドレスを検証する必要があります。 1. **環境**メニューで、メッセージを送信 AWS リージョン する を選択します。 この例では、[**環境**] メニューには次の 4 つのオプションが表示されるように Postman が設定されています。 + 米国東部 (バージニア北部) + 米国西部 (オレゴン) + 欧州 (フランクフルト) + 欧州 (アイルランド) 1. 「**メッセージ**」フォルダで、[**SendMessages**] オペレーションを選択します。 ![\[\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. [**Pre-request Script**] タブで、`projectId` 変数の値をこのセクションのステップ 2 で選択したリージョンに既に存在するプロジェクトの ID と置き換えます。 1. [**本文**] タブで、リクエストエディタに示されているリクエストの例を削除します。次のコードを貼り付けます。 ``` { "MessageConfiguration":{ "EmailMessage":{ "FromAddress":"sender@example.com", "SimpleEmail":{ "Subject":{ "Data":"Sample Amazon Pinpoint message" }, "HtmlPart":{ "Data":"

Test message

This is a sample message sent from Amazon Pinpoint using the SendMessages API.

" }, "TextPart":{ "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API." } } } }, "Addresses":{ "recipient@example.com": { "ChannelType": "EMAIL" } } } ``` 1. 前述のコードで、*sender@example.com* を検証済みの E メールアドレスに置き換えます。*recipient@example.com* を、メッセージの送信先にする検証済み E メールアドレスに置き換えます。 **注記** アカウントがまだ Amazon Pinpoint E メールサンドボックスにある場合は、Amazon Pinpoint アカウントで検証済みのアドレスまたはドメインにのみ E メールを送信できます。アカウントをサンドボックスから削除する方法については、『*Amazon Pinpoint ユーザーガイド*』の「[ Requesting production access for email](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html)」を参照してください。 1. **[送信]** を選択します。メッセージが正常に送信された場合、[レスポンス] ペインに `200 OK` のステータスが表示されます。 ``` { "ApplicationId": "12345678901234567890123456789012", "RequestId": "", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "", "MessageId": "" } } } ```