Your favorite animal is {{favoriteanimal}}.
" } } ``` このコードには次のプロパティが含まれています。 + **TemplateName** – `Template` リソースの名前。E メールを送信する場合に、この名前を参照します。 + **TemplateContent** – 次の属性のコンテナ。 + [**Subject**] – E メールの件名です。このプロパティには、置換タグが含まれる場合があります。これらのタグは以下のフォーマットを使用します: `{{tagname}}`。E メールを送信するとき、各宛先の `tagname` に対する値を指定できます。 + **Html** – E メールの HTML 本文。このプロパティには、置換タグが含まれる場合があります。前述の例には、`{{name}}` および `{{favoriteanimal}}` の 2 つのタグが含まれます。 + **Text** – E メールのテキスト本文。E メールクライアントに HTML コンテンツが表示されない受信者には、このバージョンの E メールが表示されます。また、このプロパティには置換タグが含まれる場合があります。 1. 前の例をニーズに合わせてカスタマイズし、*mytemplate.json* ファイルとして保存します。 1. コマンドラインで次のコマンドを入力し、[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html) v2 API オペレーションを使用して新しいテンプレートを作成します。 ``` aws sesv2 create-email-template --cli-input-json file://mytemplate.json ``` ## パート 3: パーソナライズされた E メールを送信する 次の 2 つの SES v2 API オペレーションを使用して、*保存済みテンプレート*または*インラインテンプレート*で E メールを送信できます。 + [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) オペレーションは、カスタマイズされた E メールを 1 つの送信先オブジェクトに送信するために役立ちます。v2 API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) オブジェクトには、*ToAddresses*、*CcAddresses*、および *BccAddresses* の各プロパティを含めることができます。これらは任意の組み合わせで使用でき、同じ E メールを受信する 1 つ以上の E メールアドレスを含めることができます。 + [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html) オペレーションは、v2 API への単一の呼び出しで複数の送信先オブジェクトそれぞれに独自の E メールを送信するために役立ちます。 このセクションでは、 を使用して、これらの AWS CLI 送信オペレーションの両方を使用してテンプレート化された E メールを送信する方法の例を示します。 ### 単一の送信先オブジェクトにテンプレートに基づく E メールを送信する [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) オペレーションを使用して、1 つの送信先オブジェクトで定義された 1 人以上の受信者に E メールを送信できます。[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) オブジェクトにあるすべての受信者に、同じ E メールが届きます。 **単一の送信先オブジェクトにテンプレートに基づく E メールを送信するには** 1. *保存済みテンプレート*を使用するか*インラインテンプレート*を使用するかに応じて、テキストエディタに貼り付けるそれぞれのコード例を選択し、必要に応じてカスタマイズします。 ------ #### [ Stored template code example ] 前のステップで作成したテンプレート *MyTemplate* が `TemplateName` パラメータの値として参照されていることに注意してください。 ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }" } }, "ConfigurationSetName": "ConfigSet" } ``` このコードには次のプロパティが含まれています。 + **FromEmailAddress** – 送信者の E メールアドレス。 + **送信先** – *ToAddresses*、*CcAddresses*、および *BccAddresses* の各プロパティで定義された E メール受信者を含むオブジェクト。これらは任意の組み合わせで使用でき、同じ E メールを受信する 1 つ以上の E メールアドレスを含めることができます。 + **TemplateContent** – 次の属性のコンテナ。 + [**Subject**] – E メールの件名です。このプロパティには、置換タグが含まれる場合があります。これらのタグは以下のフォーマットを使用します: `{{tagname}}`。E メールを送信するとき、各宛先の `tagname` に対する値を指定できます。 + **Html** – E メールの HTML 本文。このプロパティには、置換タグが含まれる場合があります。前述の例には、`{{name}}` および `{{favoriteanimal}}` の 2 つのタグが含まれます。 + **Text** – E メールのテキスト本文。E メールクライアントに HTML コンテンツが表示されない受信者には、このバージョンの E メールが表示されます。また、このプロパティには置換タグが含まれる場合があります。 + **TemplateData** – キーと値のペアを含むエスケープされた JSON 文字列。キーは、`{{name}}` など、このファイルの `TemplateContent` プロパティで定義された変数に対応します。値は変数を置き換える内容を表します。 + **ConfigurationSetName** – E メールを送信するときに使用する設定セットの名前。 **注記** レンダリング失敗イベントを Amazon SNS に発行するように設定された設定セットを使用することをお勧めします。詳細については、「[(オプション) パート 1: レンダリング失敗イベント通知を設定する](#send-personalized-email-set-up-notifications)」を参照してください。 ------ 1. 前の例をニーズに合わせてカスタマイズし、*myemail.json* ファイルとして保存します。 1. コマンドラインで、次の v2 API コマンドを入力して E メールを送信します。 ``` aws sesv2 send-email --cli-input-json file://myemail.json ``` ### 複数の送信先オブジェクトにテンプレートに基づく E メールを送信する [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html) オペレーションを使用して、SES v2 API への単一の呼び出しで、複数の送信先オブジェクトにメールを送信できます。SES は、各 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) オブジェクトで、1 名または複数の受信者それぞれに独自の E メールを送信します。 **複数の送信先オブジェクトにテンプレートに基づく E メールを送信するには** 1. *保存済みテンプレート*を使用するか*インラインテンプレート*を使用するかに応じて、テキストエディタに貼り付けるそれぞれのコード例を選択し、必要に応じてカスタマイズします。 ------ #### [ Stored template code example ] 前のステップで作成したテンプレート *MyTemplate* が `TemplateName` パラメータの値として参照されていることに注意してください。 ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"friend\", \"favoriteanimal\":\"unknown\" }" } }, "BulkEmailEntries": [ { "Destination": { "ToAddresses": [ "anaya.iyengar@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }" } } }, { "Destination": { "ToAddresses": [ "liu.jie@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }" } } }, { "Destination": { "ToAddresses": [ "shirley.rodriguez@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }" } } }, { "Destination": { "ToAddresses": [ "richard.roe@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{}" } } } ], "ConfigurationSetName": "ConfigSet" } ``` このコードには次のプロパティが含まれています。 + **FromEmailAddress** – 送信者の E メールアドレス。 + **DefaultContent** – `TemplateContent` および `TemplateData` オブジェクトを含む JSON オブジェクト。 + **TemplateContent** – 次の属性のコンテナ。 + [**Subject**] – E メールの件名です。このプロパティには、置換タグが含まれる場合があります。これらのタグは以下のフォーマットを使用します: `{{tagname}}`。E メールを送信するとき、各宛先の `tagname` に対する値を指定できます。 + **Html** – E メールの HTML 本文。このプロパティには、置換タグが含まれる場合があります。前述の例には、`{{name}}` および `{{favoriteanimal}}` の 2 つのタグが含まれます。 + **Text** – E メールのテキスト本文。E メールクライアントに HTML コンテンツが表示されない受信者には、このバージョンの E メールが表示されます。また、このプロパティには置換タグが含まれる場合があります。 + **TemplateData** – `ReplacementEmailContent` オブジェクトで空の JSON オブジェクト `{}` が `ReplacementTemplateData` プロパティに含まれている場合に使用されるキーと値のペアが含まれます。 + **BulkEmailEntries** – 1 つ以上の `Destination` オブジェクトを含む配列。 + **送信先** – *ToAddresses*、*CcAddresses*、および *BccAddresses* の各プロパティで定義された E メール受信者を含むオブジェクト。これらは任意の組み合わせで使用でき、同じ E メールを受信する 1 つ以上の E メールアドレスを含めることができます。 + **ReplacementTemplateData** – キーと値のペアを含むエスケープされた JSON 文字列。キーは、`{{name}}` など、このファイルの `TemplateContent` プロパティで定義された変数に対応します。値は E メール内の変数を置き換える内容を表します。(ここで JSON 文字列が空で、`{}` で示されている場合、`DefaultContent` オブジェクト内の `TemplateData` プロパティで定義されたキーと値のペアが使用されます)。 + **ConfigurationSetName** – E メールを送信するときに使用する設定セットの名前。 **注記** レンダリング失敗イベントを Amazon SNS に発行するように設定された設定セットを使用することをお勧めします。詳細については、「[(オプション) パート 1: レンダリング失敗イベント通知を設定する](#send-personalized-email-set-up-notifications)」を参照してください。 ------ 1. ニーズに合わせて上記のステップでコードの値を変更し、*mybulkemail.json* としてファイルを保存します。 1. コマンドラインで、次の v2 API コマンドを入力して一括 E メールを送信します。 ``` aws sesv2 send-bulk-email --cli-input-json file://mybulkemail.json ``` # E メールの高度なパーソナライズ *保存済みテンプレート*を使用している場合、つまり SES v2 API で `CreateEmailTemplate` オペレーションを使用して Amazon SES で [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html) リソースを作成した場合、Handlebars システムを活用して、ネストされた属性、配列のイテレーション、基本的な条件ステートメント、インライン部分の作成などの高度な機能を含むテンプレートを作成できます。このセクションでは、これらの機能の例を示します。 このセクションに記載されている機能の他にも、Handlebars にはさまざまな機能を提供します。詳細については、[handlebarsjs.com](https://handlebarsjs.com/guide/builtin-helpers.html) の「[Built-In Helpers](http://handlebarsjs.com)」を参照してください。 **注記** SES は、メッセージの HTML テンプレートをレンダリングするときに HTML コンテンツをエスケープしません。つまり、コンタクトフォームなどのユーザー入力データを含める場合は、クライアント側でエスケープする必要があります。 **Topics** + [入れ子の属性の解析](#send-personalized-email-advanced-nested) + [リストに対する反復処理](#send-personalized-email-advanced-iterating) + [基本的な条件ステートメントの使用](#send-personalized-email-advanced-conditionals) + [インラインパーシャルの作成](#send-personalized-email-advanced-inline-partials) ## 入れ子の属性の解析 Handlebars には入れ子パスのサポートが含まれています。入れ子パスを使うことで、複雑な顧客データを簡単に整理し、E メールテンプレート内でそのデータを参照できるようになります。 たとえば、受信者のデータをいくつかの一般的なカテゴリで整理し、各カテゴリに詳細な情報を含めることができます。以下のコード例は、このような構造を 1 人の受信者で実現しています。 ``` { "meta":{ "userId":"51806220607" }, "contact":{ "firstName":"Anaya", "lastName":"Iyengar", "city":"Bengaluru", "country":"India", "postalCode":"560052" }, "subscription":[ { "interest":"Sports" }, { "interest":"Travel" }, { "interest":"Cooking" } ] } ``` E メールテンプレートで入れ子の属性を参照するには、親属性の名前、ピリオド (.)、値を含める属性の名前の順に指定します。たとえば前述の例で示したデータ構造を使用し、それぞれの受信者のファーストネームを E メールテンプレートに含める場合は、次のテキストを E メールテンプレートに含めます。`Hello {{contact.firstName}}!` Handlebars は、複数の階層にわたって入れ子になったパスを解析できます。つまり、テンプレートのデータ構造を柔軟に設定することができます。 ## リストに対する反復処理 `each`ヘルパー関数は、配列内の項目を反復処理します。以下のコード例の E メールテンプレートでは、`each`ヘルパー関数を使用して、それぞれの受信者の関心を項目別に記載したリストを作成しています。 ``` { "Template": { "TemplateName": "Preferences", "SubjectPart": "Subscription Preferences for {{contact.firstName}} {{contact.lastName}}", "HtmlPart": "You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
", "TextPart": "Your Preferences\n\nYou have indicated that you are interested in receiving information about the following subjects:\n {{#each subscription}} - {{interest}}\n {{/each}} \nYou can change these settings at any time by visiting the Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}" } } ``` **重要** 上記のコード例の `HtmlPart`および`TextPart`属性には、読みやすくするための改行が含まれています。テンプレートの JSON ファイルでは、これらの値に改行を含めることはできません。この例を独自の JSON ファイルにコピーして貼り付ける場合は、`HtmlPart` および`TextPart`セクションの改行と不要なスペースを削除してから次に進んでください。 テンプレートを作成したら、`SendEmail`または`SendBulkEmail`オペレーションを使用し、このテンプレートを使って受信者に E メールを送信します。`Interests`オブジェクトに値が少なくとも 1 つあれば、それぞれの受信者は、項目別の関心リストを含む E メールを受信します。以下の例は、上記のテンプレートを使用した複数の受信者への E メール送信に使用できる JSON ファイルを示しています。 ``` { "Source":"Sender NameDear {{contact.firstName}},
{{#if subscription}}You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
{{else}}Please update your subscription preferences by visiting
the
Preference Center.
{{/if}}",
"TextPart": "Your Preferences\n\nDear {{contact.firstName}},\n\n
{{#if subscription}}
You have indicated that you are interested in receiving
information about the following subjects:\n
{{#each subscription}}
- {{interest}}\n
{{/each}}
\nYou can change these settings at any time by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{else}}
Please update your subscription preferences by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{/if}}"
}
}
```
**重要**
上記のコード例の`HtmlPart`および`TextPart`属性には、読みやすくするための改行が含まれています。テンプレートの JSON ファイルでは、これらの値に改行を含めることはできません。この例を独自の JSON ファイルにコピーして貼り付ける場合は、`HtmlPart`および`TextPart`セクションの改行と不要なスペースを削除してから次に進んでください。
以下の例は、上記のテンプレートを使用した複数の受信者への E メール送信に使用できる JSON ファイルを示しています。
```
{
"Source":"Sender Name You have listed the following people as your friends: This is the HTML part of the message. This is the HTML part of the message.Hello {{> fullName}}!
{{#each friends}}
",
"TextPart": "{{#* inline \"fullName\"}}
{{firstName}}{{#if lastName}} {{lastName}}{{/if}}
{{/inline~}}\n
Hello {{> fullName}}! You have listed the following people
as your friends:\n
{{#each friends}}
- {{> fullName}}\n
{{/each}}"
}
}
```
**重要**
上記のコード例の`HtmlPart`および`TextPart`属性には、読みやすくするための改行が含まれています。テンプレートの JSON ファイルでは、これらの値に改行を含めることはできません。この例を独自の JSON ファイルにコピーして貼り付ける場合は、これらのセクションの改行と不要なスペースを削除してください。
# E メールテンプレートの管理
[E メールテンプレート](send-personalized-email-api.md)の作成に加えて、Amazon SES v2 API を使用して、既存のテンプレートを更新または削除したり、既存のすべてのテンプレートを一覧表示したり、テンプレートの内容を表示したりできます。
このセクションでは、 AWS CLI を使用して SES テンプレートに関連するタスクを実行する手順について説明します。
**注記**
これらの手順では、 AWS CLIがすでにインストールされ、設定されていることを前提としています。のインストールと設定の詳細については AWS CLI、 [AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)を参照してください。
## E メールテンプレートの一覧表示
SES v2 API オペレーション [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html) を使用して、既存の E メールテンプレートのリストを表示します。
**E メールテンプレートの一覧を表示するには**
+ コマンドラインで以下のコマンドを入力します。
```
aws sesv2 list-email-templates
```
現在のリージョンの SES アカウントに既存の E メールテンプレートがある場合、このコマンドは次の例のようなレスポンスを返します。
```
{
"TemplatesMetadata": [
{
"Name": "SpecialOffers",
"CreatedTimestamp": "2020-08-05T16:04:12.640Z"
},
{
"Name": "NewsAndUpdates",
"CreatedTimestamp": "2019-10-03T20:03:34.574Z"
}
]
}
```
テンプレートをまだ作成していない場合、このコマンドはメンバーのいない`TemplatesMetadata`オブジェクトを返します。
## 特定の E メール テンプレートの内容の表示
SES v2 API オペレーション [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html) を使用して、特定の E メールテンプレートの内容を表示できます。
**E メールテンプレートの内容を表示するには**
+ コマンドラインで以下のコマンドを入力します。
```
aws sesv2 get-email-template --template-name MyTemplate
```
上記のコマンドで、*MyTemplate*を、表示したいテンプレートの名前に置き換えます。
指定したテンプレート名が SES アカウントに存在するテンプレートと一致する場合、このコマンドは次の例のようなレスポンスを返します。
```
{
"Template": {
"TemplateName": "TestMessage",
"SubjectPart": "Amazon SES Test Message",
"TextPart": "Hello! This is the text part of the message.",
"HtmlPart": "\n\nHello!
\nHello!
\n