**支援結束通知：**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 最終使用者傳訊支援。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 教學課程：將 Postman 與 Amazon Pinpoint API 搭配使用 Postman 是一種熱門工具，用於在簡單易用的圖形環境中測試 API。您可以使用 Postman 來傳送 API 請求至任何 REST API，以及接收對您請求的回應。若要測試並疑難排解您對 Amazon Pinpoint API 的呼叫，使用 Postman 是方便的作法。本教學課程包括設定 Postman，以及將 Postman 與 Amazon Pinpoint 搭配使用的程序。 **注意** 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 使用成本： + 傳送電子郵件、簡訊、行動推播，或是語音訊息 + 建立和傳送行銷活動 + 使用電話號碼驗證功能 如需深入了解使用 Amazon Pinpoint 的相關費用，請參閱 [Amazon Pinpoint 定價](https://aws.amazon.com/pinpoint/pricing/)。 # 搭配 Amazon Pinpoint 使用 Postman 的先決條件 開始本教學課程之前，請先完成下列先決條件： + 您必須擁有 AWS 帳戶。若要建立 AWS 帳戶，請前往 [https://console.aws.amazon.com/](https://console.aws.amazon.com/)：//www.** AWS **。 + 請確定您用來登入 的帳戶 AWS 管理主控台 可以建立新的 IAM 政策和角色。 + 確認您至少建立了一個範例專案，該專案要開啟電子郵件，且有個已驗證的電子郵件身分。請參閱 *Amazon Pinpoint 使用者指南*中的[使用電子郵件支援建立 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 網站](https://www.getpostman.com)下載 Postman。 + 在電腦安裝 Postman 後，建立一個 Postman 帳戶。首次啟動 Postman 應用程式時，系統會提示您登入或建立新帳戶。按照 Postman 提供的說明登入帳戶，或建立帳戶 (如果您沒有帳戶的話)。 **下一步**：[建立 IAM 政策及角色](tutorials-using-postman-iam-user.md) # 建立與 Amazon Pinpoint 搭配使用的 IAM 政策和角色 若使用 Postman 測試 Amazon Pinpoint API，第一步就是建立使用者。本節中，您需要建立一個政策，讓使用者能與所有 Amazon Pinpoint 資源互動。然後建立一個使用者，並直接連接政策。 ## 建立 IAM 政策 了解如何建立 IAM 政策。使用此政策的使用者和角色，可以與 Amazon Pinpoint API 中的所有資源互動。此外還讓您存取與 Amazon Pinpoint 電子郵件 API 相關聯的資源，以及 Amazon Pinpoint SMS 和語音 API。 **建立政策** 1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。 1. 在導覽窗格中，選擇**政策**，然後選擇**建立政策**。 1. 在**政策編輯器**中，選取 **JSON**。刪除**政策編輯器**中任何最新的 JSON，使其空白。將下列 JSON 複製並貼到**政策編輯器**中，然後在**政策編輯器**中以您的 AWS 帳戶 ID 取代 *123456789012* 的所有執行個體。 您可以在主控台的右上角找到您的 AWS 帳戶 ID，也可以使用 CLI，請參閱[尋找 AWS 您的帳戶 ID](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)。 **注意** 為了保護您 Amazon Pinpoint 帳戶中的資料，此政略只包含允許您讀取、建立和修改資源的許可。它不包含允許您刪除資源的許可。您可以使用 IAM 主控台中的視覺化編輯器修改此政策。詳情請參閱 IAM 使用者指南中的[管理 IAM 政策](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 和語音 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**。選擇**建立政策**。 1. (選用) 選取**新增標籤**，可將標籤加入政策。 1. 選擇下**一步：檢閱**。 ## 建立 IAM 使用者 **警告** IAM 使用者具有長期憑證，這會造成安全風險。為了協助降低此風險，建議您只為這些使用者提供執行任務所需的許可，並在不再需要這些使用者時將其移除。 建立政策後，您可以建立一個使用者並連接政策。建立使用者時，IAM 會為您提供一組允許 Postman 執行 Amazon Pinpoint API 操作的憑證。 **建立使用者** 1. 前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 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. 當您準備好建立使用者，請選擇 **Create user (建立使用者)**。 ## 建立存取金鑰 **警告** 此種情況需要具備程式化存取權限且擁有長期憑證的 IAM 使用者，此舉將構成安全風險。為了協助降低此風險，建議您只為這些使用者提供執行任務所需的許可，並在不再需要這些使用者時將其移除。必要時可以更新存取金鑰。如需詳細資訊，請參閱《IAM 使用者指南》**中的[更新存取金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html)。 IAM 提供一組允許 Postman 執行 Amazon Pinpoint API 操作的憑證。 **建立使用者** 1. 前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。 1. 在 IAM 主控台的導覽面板中，選擇**使用者**。選取在[建立 IAM 使用者中建立的使用者 ](#tutorials-using-postman-iam-user-create-user)(**PostmanUser**)，然後選取**安全登入**資料索引標籤。 1. 在**存取金鑰**區段中，選擇**建立存取金鑰**。 1. 在**存取金鑰最佳實務和替代方案**頁面上，選取在**外部執行的應用程式 AWS**。 然後選擇**下一步**。 1. (選用) 您可以將描述標籤加入政策。 1. 選擇** Create access key (建立新的存取金鑰)**。 1. 在**擷取存取金鑰頁面**上，複製**存取金鑰**和**私密存取金鑰**欄位中的憑證。 **注意** 您必須在本教學課程中，提供存取金鑰 ID 和私密存取金鑰。這是您唯一能夠檢視私密存取金鑰的時間。建議您複製並儲存在安全的位置。 1. 儲存兩個金鑰之後，選擇**完成**。 **下一步**：[設定 Postman](tutorials-using-postman-configuration.md) # 設定 Postman 以搭配 Amazon Pinpoint 使用 您已經建立了能夠存取 Amazon Pinpoint API 的用戶，現在就來設定 Postman。在本節中，您將在 Postman 中建立一或多個環境。接著匯入一個集合，將 Amazon Pinpoint API 中每個操作的請求範本包含在內。 ## 建立 Postman 工作區 在 Postman 中，*工作空間*是專案和環境的組織容器。本節中，您需要建立至少一個工作空間，與 Amazon Pinpoint 搭配使用。 **建立工作區** 在 Postman 中，依序選擇更多動作、**檔案**，然後選擇**新增**。 1. 在**新建**視窗中，選擇**工作空間**。 1. 輸入名稱、摘要，並將可見性設為個人。然後選擇**建立工作空間**。 ## 建立 Postman 環境 在 Postman 中，*環境*是儲存為鍵值組形式的一組變數。使用環境即可變更您透過 Postman 提出的請求的組態，不須變更 API 請求本身。 本節中，您需要建立至少一個環境，與 Amazon Pinpoint 搭配使用。您建立的每個環境，在單一 AWS 區域中包含一組您帳戶專用的變數。若使用本節程序建立多個環境，可從 Postman的**環境**功能表選擇不同的環境，在區域之間變更。 **建立環境** 1. 在 Postman 中，選擇更多動作功能表，選擇**檔案**，然後選擇**新增**。 1. 在 **Create New (建立新項目)** 視窗中，選擇 **Environment (環境)**。 1. 在 **MANAGE ENVIRONMENTS (管理環境)** 視窗中，對於 **Environment Name (環境名稱)**，輸入 **Amazon Pinpoint - *Region Name***。將 *Region Name (區域名稱)* 替換為下列其中一個值： + 美國東部 (維吉尼亞北部) + 美國西部 (奧勒岡) + 亞太地區 (孟買) + 亞太地區 (悉尼) + 歐洲 (法蘭克福) + 歐洲 (愛爾蘭) **注意** 您至少只需要為單一 建立一個環境 AWS 區域，且 AWS 區域 必須包含一個專案。如果您尚未在先前列出的其中一個 中建立專案 AWS 區域，請參閱《[Amazon Pinpoint 使用者指南》中的使用電子郵件支援建立](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) *Amazon Pinpoint *專案。 1. 建立六個新變數：`endpoint`、`region`、`serviceName`、`accountId`、`accessKey` 和 `secretAccessKey`。使用下表，判斷要在每個變數的**初始值**和**目前值**欄位中輸入哪個值。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/tutorials-using-postman-configuration.html) 建立這些變數後，**MANAGE ENVIRONMENTS (管理環境)** 視窗會類似於下圖所示的範例。 ![\[\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png) 完成後，請選擇**儲存**。 **重要** 上圖中的存取金鑰是虛構的。請勿與他人共用您的 IAM 存取金鑰。 Postman 包含的功能，可讓您分享和匯出環境。如果使用這些功能，請不要與任何無權存取這些憑證的人員分享您的存取金鑰 ID 和私密存取金鑰。 如需詳細資訊，請參閱《[IAM 使用者指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)》中的 *IAM 最佳實務*。 1. (選用) 針對您要建立的每個其他環境，重複步驟 1 – 4。 **提示** 在 Postman 中，您可以建立任意數量的環境。您可以透過以下方法使用環境： 針對您必須測試 Amazon Pinpoint API 的每個區域，個別建立環境。 建立與不同 AWS 帳戶相關聯的環境。 建立使用了與其他使用者相關聯的憑證的環境。 1. 當您完成建立環境，請移至下一節。 ## 在 Postman 中建立 Amazon Pinpoint 集合 在 Postman 中，*集合*是一組 API 請求。集合中的請求通常由共同目標結合在一起。本節中，您需要在 Amazon Pinpoint API 中建立一個新集合，並包含每個操作的請求範本。 **若要建立 Amazon Pinpoint 集合** 1. 在 Postman 中，選擇更多動作功能表，選擇**檔案**，然後選擇**匯入**。 1. 在 **Import (匯入)** 視窗中，選擇 **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 會匯入 Amazon Pinpoint 集合，該集合包含 120 個範例請求。 ## 測試您的 Postman 組態 匯入 Amazon Pinpoint 集合後，建議您執行快速測試，確認所有元件均已正確設定。您可以透過提交 `GetApps` 請求來測試您的組態。此請求會針對目前 AWS 區域中，您 Amazon Pinpoint 帳戶裡所有的專案，傳回一份清單。此請求不需要額外的組態，因此是測試組態的好方法。 **若要測試 Amazon Pinpoint 集合的組態** 1. 在左側導覽面板中，選取**集合**，展開 **Amazon Pinpoint** 集合，然後展開**應用程式**資料夾。 1. 在請求清單中，選擇 **GetApps**。 1. 使用**環境**選擇器選擇您在[建立 Postman 環境中建立的環境](#tutorials-using-postman-configuration-create-environments)。 1. 選擇**傳送**。如果請求成功傳送，回應窗格會顯示 `200 OK` 的狀態。您會看到類似下圖範例的回應。 ![\[\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png) **注意** 如果您沒有在 中建立任何專案 AWS 區域 ，則 Amazon Pinpoint 會傳回 `{ "Item": [] }`。 這個回應針對您在步驟 3 選擇的區域，列出帳戶中所有存在的 Amazon Pinpoint 專案。 ### 疑難排解 當您提交請求時，可能會看到錯誤。請參閱以下清單，了解您可能會遇到的數個常見錯誤，以及您可以採取以解決問題的步驟。 | 錯誤訊息 | 問題 | Resolution | | --- | --- | --- | | 無法取得任何回應 連接到 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)中建立環境時提供了正確的登入資料。 | **下一步**：[傳送其他請求](tutorials-using-postman-sample-requests.md) # 將請求傳送至 Amazon Pinpoint API 完成設定和測試 Postman 後，就能開始傳送其他請求到 Amazon Pinpoint API。本節告訴您，傳送請求之前必須了解哪些重要資訊，並另提供兩個請求範例，說明如何使用 Amazon Pinpoint 集合。 **重要** 完成本節的程序後，請將請求提交到 Amazon Pinpoint API。這些請求會在您的 Amazon Pinpoint 帳戶中建立新資源、修改現有資源、傳送訊息、變更 Amazon Pinpoint 專案的組態，以及使用其他 Amazon Pinpoint 功能。執行請求時請務必小心。 ## Amazon Pinpoint Postman 集合中的範例 您必須先在 Amazon Pinpoint Postman 集合中設定大部分的操作，才能開始使用。對於 `GET` 和 `DELETE` 操作，通常只需要修改 **Pre-request Script (預先請求指令碼)** 標籤上設定的變數。 **注意** 當您使用建立 IAM 政策中[顯示的 IAM 政策](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)時，無法執行此集合中包含的任何`DELETE`請求。 例如，`GetCampaign` 操作需要您指定 `projectId` 和 `campaignId`。在 **Pre-request Script (預先請求指令碼)** 標籤中，這兩個變數都存在，並填入範例值。刪除範例值，並將範例值替換成適合您 Amazon Pinpoint 專案和行銷活動的值。 這些變數中，最常用的是 `projectId` 變數。此變數的值應該是您請求所適用之專案的唯一識別符。若要為專案取得這些識別碼的清單，請從先前步驟傳送的 `GetApps` 請求查看回應。在該回應中，`Id` 欄位會提供專案的唯一識別碼。若要進一步了解回應中每個欄位的 `GetApps` 操作和意義，請參閱《Amazon Pinpoint API 參考》中的[應用程式](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html)。 **注意** 在 Amazon Pinpoint 中，「專案」等同「應用程式」。 對於 `POST` 和 `PUT` 操作，您也必須修改請求內文，附上您要傳送到 API 的值。例如提交 `CreateApp` 請求時 (也就是 `POST` 請求)，必須為建立的專案指定名稱。您可以在 **Body (內文)** 標籤上修改請求。在這個範例中，將 `"Name"` 旁的值替換為專案的名稱。如果您想要新增標籤到專案，您可以在 `tags` 物件中指定。或者，如果您不想新增標籤，也可以刪除整個 `tags` 物件。 **注意** `UntagResource` 操作還需要您指定 URL 參數。您可以在 **Params (參數)** 標籤上指定這些參數。將 **VALUE (值)** 欄中的值替換為您要為指定資源刪除的標籤。 ## 範例請求：使用 `CreateApp`操作建立專案 在 Amazon Pinpoint 中開始建立客群和行銷活動之前，您必須先建立一個專案。在 Amazon Pinpoint 中，*專案*包含的客群、行銷活動、組態和資料，全都具有共同目標。例如，您可以使用專案來包含與特定應用程式、特定品牌或行銷計劃相關的所有內容。將客戶資訊加入 Amazon Pinpoint 時，資訊將與專案建立關聯。 **透過傳送 CreateApp API 請求來建立專案** 1. 在**環境**功能表中，選擇您要 AWS 區域 在其中建立專案的 。 ![\[\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) 在這個範例中，Postman 已設定為讓 **Environments (環境)** 功能表顯示以下四個選項： + 美國東部 (維吉尼亞北部) + 美國西部 (奧勒岡) + 歐洲 (法蘭克福) + 歐洲 (愛爾蘭) 1. 在**應用程式**資料夾中，選擇**CreateApp** 操作。 ![\[\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) 展開的Amazon Pinpoint Postman 集合中的**應用程式**資料夾，並顯示以下請求： + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. 在 **Body (內文)** 標籤的 `"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`操作傳送電子郵件 使用 Amazon Pinpoint `SendMessages` API 傳送交易訊息很常見。比起建立行銷活動，使用 `SendMessages` API 傳送訊息的其中一個優點，就是可以將訊息傳送到任何地址，例如電子郵件地址、電話號碼或裝置權杖。接收訊息的地址，不一定要在您的 Amazon Pinpoint 帳戶內。接下來就在此方法與建立行銷活動來傳送訊息這兩者之間比較。在 Amazon Pinpoint 中傳送行銷活動之前，您必須先將端點加入 Amazon Pinpoint 帳戶、建立客群、建立行銷活動，以及執行行銷活動。 本節中的範例說明如何直接傳送交易電子郵件訊息到特定的電子郵件地址。您可以修改此請求為透過其他管道傳送訊息，例如簡訊、行動推播或語音。 **若要透過提交 SendMessages 請求來傳送電子郵件訊息** 1. 確認已為專案啟用電子郵件管道，並且已設定要用來傳送和接收郵件的電子郵件地址或域。詳情請參閱 *Amazon Pinpoint 使用者指南*中的[啟用和停用電子郵件管道](pinpoint/latest/userguide/channels-email-setup.html)和[驗證電子郵件身分](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html)。 **注意** 若要完成本節的程序，您必須驗證電子郵件地址 1. 在**環境**功能表上，選擇要 AWS 區域 傳送訊息的 。 在這個範例中，Postman 已設定為讓 **Environments (環境)** 功能表顯示以下四個選項： + 美國東部 (維吉尼亞北部) + 美國西部 (奧勒岡) + 歐洲 (法蘭克福) + 歐洲 (愛爾蘭) 1. 在 **Messages (訊息)** 資料夾中，選擇 **SendMessages** 操作。 ![\[\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. 在 **Pre-request Script (預先請求指令碼)** 標籤中，將 `projectId` 變數取代為區域中已存在專案的 ID，或是您在本節步驟 2 中選取專案的 ID。 1. 在 **Body (內文)** 標籤上，刪除顯示在請求編輯器中的範例請求。貼上以下程式碼： ``` { "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* 替換為您的已驗證電子郵件地址。將 *recipient@example.com* 替換成郵件的目的地電子郵件地址 (電子郵件地址必須通過驗證)。 **注意** 如果您的帳戶仍在 Amazon Pinpoint 電子郵件沙盒中，您只能將電子郵件傳送到已在您 Amazon Pinpoint 帳戶中驗證的地址或域。如需從沙盒移除帳戶的詳細資訊，[請參閱 *Amazon Pinpoint 使用者指南*中的請求電子郵件的製作存取權](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": "" } } } ```