使用列表管理

要创建联系人列表，请使用 AWS CLI

• 在命令行输入以下命令：

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

  在前面的命令中，CONTACT-LIST-JSON替换为CreateContactList请求的 JSON 文件的路径。

  请求的 CreateContactList 输入 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 输入 JSON 文件的示例如下：

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

  在以上示例中，UnsubscribeAll 值为 false 表明联系人未取消订阅所有主题，而值为 true 则意味着联系人已取消订阅所有主题。

  TopicPreferences 包含有关联系人的主题订阅状态的信息。在前面的示例中，联系人选择订阅了“Sports”主题，那么他将收到“Sports”主题的所有电子邮件。

  AttributesData 是一个 JSON 字段，您可以在其中放置有关我们的联系人的任何元数据。它必须是有效的 JSON 对象。

1. 使用列出联系人 AWS CLI — 您可以使用该ListContacts操作来检索已订阅特定主题的所有联系人的列表，以及允许您向他们发送电子邮件的SendEmail操作。

   在命令行输入以下命令：

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

   在前面的命令中，LIST-CONTACTS-JSON替换为ListContacts请求的 JSON 文件的路径。

   请求的 ListContacts 输入 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 操作在列表中列出联系人后，您可以使用 SendEmail 操作，通过 ListManagementOptions 标头指定联系人列表和主题名，以向每个联系人发送电子邮件。

   要将 ListManagementOptions 与 SendEmail 操作一起使用，请包括电子邮件所属的 contactListName 和 topicName（可选）：

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   如果您在发送给不在您联系人列表中的收件人电子邮件地址的 SendEmail 请求中包含 ListManagementOptions，那么您的列表中会自动创建联系人。

   如果将电子邮件发送给您的联系人列表中已取消订阅的联系人，那么 Amazon SES 将退回该电子邮件，这意味着您不需要更新您的 SendEmail 请求即可避免向已取消订阅的联系人发送邮件。

3. 指明取消订阅链接的位置 – 利用 ListManagementOptions 时，您可以通过使用 {{amazonSESUnsubscribeUrl}} 占位符指定 Amazon SES 需要插入取消订阅 URL 的位置，选择让 SES 在电子邮件中添加取消订阅脚注链接。仅支持 HTML 和 TEXT 内容类型的占位符替换。您可以最多两次包含该占位符。如果使用了两次以上，那么仅替换前两次出现的占位符。有关更多信息，请参阅 使用订阅管理。

   或者，如果使用 SMTP 接口发送电子邮件，则可以使用 X-SES-LIST-MANAGEMENT-OPTIONS 标头指定列表和主题名称。

   要指定在使用 SMTP 接口发送电子邮件时的列表和主题名称，请将以下电子邮件标头添加到您的邮件：

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