リスト管理の使用

を使用して連絡先リストを作成するには AWS CLI

• コマンドラインで以下のコマンドを入力します。

  aws sesv2 create-contact-list --cli-input-json file://CONTACT-LIST-JSON

  上記のコマンドで、CONTACT-LIST-JSON を CreateContactList リクエストの JSON ファイルへのパスに置き換えます。

  リクエストのための CreateContactList input JSON ファイルの例を次に示します。

  {
      "ContactListName": "ExampleContactListName",
      "Description": "Creating a contact list example",
      "Topics": [
       {
           "TopicName": "Sports",
           "DisplayName": "Sports Newsletter",
           "Description": "Sign up for our free newsletter to receive updates on all sports.",
           "DefaultSubscriptionStatus": "OPT_OUT"
       },
       {
           "TopicName": "Cycling",
           "DisplayName": "Cycling newsletter",
           "Description": "Never miss a cycling update by subscribing to our newsletter.",
           "DefaultSubscriptionStatus": "OPT_IN"
       },
       {
           "TopicName": "NewProducts",
           "DisplayName": "New products",
           "Description": "Hear about new products by subscribing to this mailing list.",
           "DefaultSubscriptionStatus": "OPT_IN"
       },
       {
           "TopicName": "DailyUpdates",
           "DisplayName": "Daily updates",
           "Description": "Start your day with sport updates, Monday through Friday.",
           "DefaultSubscriptionStatus": "OPT_OUT"
       }
      ]
  }

を使用して連絡先を作成するには AWS CLI

• コマンドラインで以下のコマンドを入力します。

  aws sesv2 create-contact --cli-input-json file://CONTACT-JSON

  上記のコマンドで、CONTACT-JSON を CreateContact リクエストの JSON ファイルへのパスに置き換えます。

  リクエストのための CreateContact input JSON ファイルの例を次に示します。

  {
      "ContactListName": "ExampleContactListName",
      "EmailAddress": "example@amazon.com",
      "UnsubscribeAll": false,
      "TopicPreferences": [
          {
              "TopicName": "Sports",
              "SubscriptionStatus": "OPT_IN"
          }
      ],
      "AttributesData": "{\"Name\": \"John\", \"Location\": \"Seattle\"}"
  }

  上の例で、false の UnsubscribeAll 値は、連絡先がすべてのトピックの購読を解除していないことを示し、true の値は、連絡先がすべてのトピックの購読を解除したことを意味します。

  TopicPreferences には、連絡先のトピックへのサブスクリプションステータスに関する情報が含まれています。前述の例では、連絡先は「スポーツ」トピックにオプトインしており、「スポーツ」トピックへのすべての E メールを受信します。

  AttributesData は JSON フィールドで、連絡先に関するメタデータを格納できます。有効な JSON オブジェクトである必要があります。

1. を使用して連絡先を一覧表示 AWS CLIする – ListContactsオペレーションを使用して、特定のトピックにサブスクライブしているすべての連絡先のリストを SendEmailオペレーションと組み合わせて取得できます。これにより、連絡先に E メールを送信できます。

   コマンドラインで以下のコマンドを入力します。

   aws sesv2 list-contacts --cli-input-json file://LIST-CONTACTS-JSON

   上記のコマンドで、LIST-CONTACTS-JSON を ListContacts リクエストの JSON ファイルへのパスに置き換えます。

   リクエストのための ListContacts input JSON ファイルの例を次に示します。

   {
       "ContactListName": "ExampleContactListName",
       "Filter": {
           "FilteredStatus": "OPT_IN",
           "TopicFilter": {
               "TopicName": "Cycling",
               "UseDefaultIfPreferenceUnavailable": true
           }
       },
       "PageSize": 50
   }

   FilteredStatus には、フィルタリングする購読ステータス (OPT_IN または OPT_OUT) が表示されます。

   TopicFilter は、結果が欲しいトピックを指定するオプションのフィルターです。上記の例では「Cycling」です。

   UseDefaultIfPreferenceUnavailable は、true または false の値を持つことができます。true の場合、連絡先にトピックに対する明示的な設定がなければ、トピックのデフォルト設定が使用されます。false の場合、明示的に定めた設定を持つ連絡先のみがフィルタリングの対象となります。

2. ListManagementOptions を有効にしてメールを送信 — 上記の ListContactsオペレーションを使用してリスト内の連絡先を一覧表示した後、ListManagementOptions ヘッダーを利用して、連絡先リストとトピック名を指定し、SendEmail オペレーションを利用して各連絡先にメールを送信できます。

   SendEmail オペレーションで ListManagementOptions を使用するには、メールが属している contactListName と topicName を含めます (topicName はオプションです):

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   連絡先リストにない受信者の E メールアドレスへの SendEmail リクエストに ListManagementOptions を含めると、連絡先がリストに自動的に作成されます。

   連絡先リストにある登録解除済み連絡先にメールを送信した場合、Amazon SES は E メールをバウンスします。つまり、登録解除した連絡先に送信されないようにするために SendEmail リクエストを更新する必要はありません。

3. サブスクリプション解除のリンクの場所を示す — ListManagementOptions を利用する場合、Amazon SES を有効にし、{{amazonSESUnsubscribeUrl}} プレースホルダを使用して、SES でサブスクリプションの解除 URL を挿入する必要がある場所を指定して、E メールにサブスクリプションの解除フッターリンクを追加できるオプションがあります。プレースホルダの置き換えは、HTML および TEXT コンテンツタイプでのみサポートされます。プレースホルダは、最大 2 倍含めることができます。2 回以上使用した場合、最初の 2 つのオカレンスのみが置き換えられます。詳細については、「サブスクリプションの使用」を参照してください。

   または、SMTPインターフェイスで E メールを送信しながら、X-SES-LIST-MANAGEMENT-OPTIONS ヘッダーを使用してリストとトピック名を指定します。

   SMTP インターフェイスを使用して E メールを送信するときにリストとトピック名を指定するには、次の E メールヘッダーをメッセージに追加します。

   X-SES-LIST-MANAGEMENT-OPTIONS: {contactListName}; topic={topicName}