Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden von Listenverwaltung
Amazon SES bietet Funktionen zur Listenverwaltung, d. h. Kunden können ihre eigenen Mailinglisten, die als Kontaktlisten bezeichnet werden, verwalten. Eine *Kontaktliste* ist eine Liste, mit der Sie alle Ihre Kontakte speichern können, die ein bestimmtes Thema oder bestimmte Themen abonniert haben. Ein *Kontakt* ist ein Endbenutzer, der Ihre E-Mails erhält. Ein *Thema* ist eine Interessengruppe, ein Design oder ein Label innerhalb einer Liste. Listen können mehrere Themen haben.
Durch die Verwendung der [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)-Operation in der Amazon SES API v2 können Sie eine Liste aller Kontakte abrufen, die ein bestimmtes Thema abonniert haben, an die Sie mit der [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)-Operation E-Mails senden können.
Weitere Informationen zu Jahresabonnements finden Sie unter [Abonnementverwaltung](sending-email-subscription-management.md).
## Übersicht über die Verwaltung von
Sie sollten die folgenden Faktoren berücksichtigen, wenn Sie die globale Unterdrückungsliste verwenden:
+ Sie können Listenthemen beim Erstellen der Liste angeben.
+ Pro ist nur eine Kontaktliste zulässig AWS-Konto.
+ Eine Liste kann maximal 20 Themen haben.
+ Sie können eine vorhandene Kontaktliste aktualisieren. Dazu gehören das Hinzufügen neuer Themen zur Liste, das Hinzufügen oder Löschen von Kontakten aus einer Liste und das Aktualisieren von Kontakteinstellungen für eine Liste oder ein Thema.
+ Sie können Topic-Metadaten aktualisieren, z. B. den Anzeigenamen oder die Beschreibung des Themas.
+ Sie können eine Liste der Kontakte in einer Kontaktliste, Kontakte, die ein Thema abonniert haben, Kontakte, die von einem Thema abgemeldet wurden, sowie Kontakte abrufen, die von allen Themen in der Liste abgemeldet wurden.
+ Sie können Ihre vorhandenen Kontaktlisten mithilfe der [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)API in SES importieren.
+ SES gibt ein Bounce-Event für eine Nachricht aus, die an einen Kontakt auf Ihrer Kontaktliste gesendet wird, der sich nicht abonniert hat. Weitere Informationen finden Sie unter [Abonnementverwaltung](sending-email-subscription-management.md).
+ Jedem Kontakt kann zugeordnete Attribute aufweisen, mit denen Sie Informationen zu diesem Kontakt speichern können.
## Konfigurieren der Listenverwaltung
Sie können zur Konfiguration von Listenverwaltungsfunktionen wie folgt verwenden: Eine vollständige Liste der Kontaktlisten und -operationen finden Sie im[Amazon SES API v2-Referenz](https://docs.aws.amazon.com/ses/latest/APIReference-V2/Welcome.html)aus.
### Erstellen von Gesprächslisten
Sie können den [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html)Vorgang in der SES-API v2 verwenden, um eine Kontaktliste zu erstellen. Sie können diese Einstellung schnell und einfach konfigurieren, indem Sie die AWS CLI verwenden. Weitere Informationen zur Installation und Konfiguration von finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
**Um eine Kontaktliste mit dem zu erstellen AWS CLI**
+ Geben Sie in der Befehlszeile folgenden Befehl ein:
```
aws sesv2 create-contact-list --cli-input-json file://{{CONTACT-LIST-JSON}}
```
Ersetzen Sie es im vorherigen Befehl {{CONTACT-LIST-JSON}} durch den Pfad zu Ihrer JSON-Datei für Ihre [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html)Anfrage.
Eine Beispielhafte `CreateContactList`-Eingabe-JSON-Datei für die Anforderung ist wie folgt:
```
{
"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"
}
]
}
```
### So erstellen Sie einen Kontakt
Sie können den [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html)Vorgang in der SES-API v2 verwenden, um einen Kontakt zu erstellen. Sie können diese Einstellung schnell und einfach konfigurieren, indem Sie die AWS CLI verwenden. Weitere Informationen zur Installation und Konfiguration von finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
**Um einen Kontakt mit dem zu erstellen AWS CLI**
+ Geben Sie in der Befehlszeile folgenden Befehl ein:
```
aws sesv2 create-contact --cli-input-json file://{{CONTACT-JSON}}
```
Ersetzen Sie es im vorherigen Befehl {{CONTACT-JSON}} durch den Pfad zu Ihrer JSON-Datei für Ihre [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html)Anfrage.
Eine Beispielhafte `CreateContact`-Eingabe-JSON-Datei für die Anforderung ist wie folgt:
```
{
"ContactListName": "ExampleContactListName",
"EmailAddress": "example@amazon.com",
"UnsubscribeAll": false,
"TopicPreferences": [
{
"TopicName": "Sports",
"SubscriptionStatus": "OPT_IN"
}
],
"AttributesData": "{\"Name\": \"John\", \"Location\": \"Seattle\"}"
}
```
Im obigen Beispiel zeigt ein `UnsubscribeAll`-Wert von `false`an, dass sich der Kontakt nicht von allen Themen abgemeldet hat, wobei der Wert `true` bedeuten würde, dass sich der Kontakt von allen Themen abgemeldet hat.
`TopicPreferences` enthält Informationen zum Abonnementstatus des Kontakts für Themen. Im vorangegangenen Beispiel hat sich der Kontakt für das Thema „*Sport*“ entschieden und erhält alle E-Mails zum Thema „*Sport*“.
`AttributesData` ist ein JSON-Feld, in dem Sie beliebige Metadaten über unseren Kontakt einfügen können. Es muss ein gültiges JSON-Objekt sein.
### Massenimport von Kontakten in Ihre Kontaktliste
Sie können Adressen manuell in großen Mengen hinzufügen, indem Sie zuerst Ihre Kontakte in ein Amazon S3 S3-Objekt hochladen und anschließend den [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)Vorgang in der SES API v2 oder die SES-Konsole verwenden. Weitere Informationen finden Sie unter [Hinzufügen von E-Mail-Adressen in Ihrer Unterdrückungsliste auf Kontoebene](sending-email-suppression-list.md#sending-email-suppression-list-manual-add-bulk).
Sie sollten eine Kontaktliste erstellen, bevor Sie Ihre Kontakte importieren.
**Anmerkung**
Sie können einer Kontaktliste bis zu 1 Million Kontakte pro Person ImportJob hinzufügen.
Führen Sie die folgenden Schritte aus, um der Kontaktliste mehrere Kontakte hinzuzufügen.
+ Laden Sie Ihre Kontakte in ein Amazon S3 Objekt im CSV- oder JSON-Format hoch.
**CSV-Format**
Die erste Zeile der Datei, die in Amazon S3 hochgeladen wird, sollte eine Kopfzeile sein.
Das `topicPreferences`-Objekt muss für das CSV-Format abgeflacht werden. Jedes Thema in den `topicPreferences` hat ein separates Kopfzeilenfeld.
CSV-Format Beispiel für das Hinzufügen von Kontakten in einem Massenformat zu einer Kontaktliste:
```
emailAddress,unsubscribeAll,attributesData,topicPreferences.Sports,topicPreferences.Cycling
example1@amazon.com,false,{"Name": "John"},OPT_IN,OPT_OUT
example2@amazon.com,true,,OPT_OUT,OPT_OUT
```
**JSON-Format**
Nur durch Zeilenumbrüche getrennte JSON-Dateien werden unterstützt. In diesem Format ist jede Zeile ein vollständiges JSON-Objekt mit den Informationen eines Kontakts.
Beispiel für das JSON-Format zum Hinzufügen von Kontakten in einer Kontaktliste:
```
{
"emailAddress": "example1@amazon.com",
"unsubscribeAll": false,
"attributesData": "{\"Name\":\"John\"}",
"topicPreferences": [
{
"topicName": "Sports",
"subscriptionStatus": "OPT_IN"
},
{
"topicName": "Cycling",
"subscriptionStatus": "OPT_OUT"
}
]
}
{
"emailAddress": "example2@amazon.com",
"unsubscribeAll": true,
"topicPreferences": [
{
"topicName": "Sports",
"subscriptionStatus": "OPT_OUT"
},
{
"topicName": "Cycling",
"subscriptionStatus": "OPT_OUT"
}
]
}
```
Ersetzen Sie in den vorherigen Beispielen {{example1@amazon.com}} und {{example2@amazon.com}} durch die E-Mail-Adressen, die Sie der Kontaktliste hinzufügen möchten. Ersetzen Sie die `attributesData`-Werte durch die für den Kontakt spezifischen Werte. Ersetzen Sie außerdem {{Sports}} und {{Cycling}} durch `topicName` das, was für Ihren Kontakt gilt. Zulässig `topicPreferences` sind {{OPT\_IN}} und{{OPT\_OUT}}.
Die folgenden Attribute werden unterstützt, wenn Sie Ihre Kontakte in ein Amazon S3 Objekt im CSV- oder JSON-Format hochladen:
[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/ses/latest/dg/sending-email-list-management.html)
+ Erteilen Sie SES Berechtigung, das Amazon S3 Objekt zu lesen.
Bei Anwendung auf einen Amazon-S3-Bucket erteilt die folgenden Richtlinie SES die Berechtigung zum Schreiben von Daten in diesen Bucket. Weitere Informationen zu Bucket-Richtlinien für Amazon S3 finden Sie unter [Verwenden von Bucket-Richtlinien und Benutzerrichtlinien](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) im *Entwicklerhandbuch zu Amazon Simple Storage Service*.
+ Erteilen Sie SES die Erlaubnis, Ihren AWS KMS Schlüssel zu verwenden.
Wenn das Amazon S3 S3-Objekt mit einem AWS KMS Schlüssel verschlüsselt ist, müssen Sie Amazon SES die Erlaubnis zur Verwendung des KMS-Schlüssels erteilen. SES kann nur die Berechtigung von einem vom Kunden verwalteten Schlüssel erhalten, nicht von einem standardmäßigen KMS-Schlüssel. Sie müssen SES die Erlaubnis zur Verwendung des vom Kunden verwalteten Schlüssels erteilen, indem Sie der Richtlinie für den Schlüssel eine Erklärung hinzufügen.
Fügen Sie die folgende Richtlinienanweisung in die Schlüsselrichtlinie ein, um SES zu erlauben, Ihren vom Kunden verwalteten Schlüssel zu verwenden.
```
{
"Sid": "AllowSESToDecrypt",
"Effect": "Allow",
"Principal": {
"Service":"ses.amazonaws.com"
},
"Action": [
"kms:Decrypt",
],
"Resource": "*"
}
```
+ Verwenden Sie den [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)Vorgang in der SES-API v2.
**Anmerkung**
Im folgenden Verfahren wird davon ausgegangen, dass Sie den AWS CLI bereits installiert haben. Weitere Informationen zur Installation und Konfiguration von finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
Geben Sie in der Befehlszeile den folgenden Befehl ein: Ersetzen {{s3bucket}} Sie durch den Namen des Amazon S3 S3-Buckets und {{s3object}} durch den Namen des Amazon S3 S3-Objektnamens.
```
aws sesv2 create-import-job --import-destination ContactListDestination={ContactListName=ExampleContactListName,ContactListImportAction=PUT} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV
```
## Exemplarische Vorgehensweise zur Listenverwaltung mit Beispielen
Die folgende exemplarische Vorgehensweise enthält Beispiele, wie Sie mit der Listenverwaltung Ihre Kontakte aufführen und `ListManagementOptions` nutzen können, um eine Kontaktliste und einen Themennamen in Ihrer E-Mail anzugeben und Abmeldelinks einzufügen.
1. **Kontakte auflisten mit dem AWS CLI** — Sie können den [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)Vorgang verwenden, um in Verbindung mit dem [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)Vorgang eine Liste all Ihrer Kontakte abzurufen, die ein bestimmtes Thema abonniert haben, sodass Sie ihnen E-Mails senden können.
Geben Sie in der Befehlszeile folgenden Befehl ein:
```
aws sesv2 list-contacts --cli-input-json file://{{LIST-CONTACTS-JSON}}
```
Ersetzen Sie dies im vorherigen Befehl {{LIST-CONTACTS-JSON}} durch den Pfad zu Ihrer JSON-Datei für Ihre [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)Anfrage.
Eine Beispielhafte `ListContacts`-Eingabe-JSON-Datei für die Anforderung ist wie folgt:
```
{
"ContactListName": "ExampleContactListName",
"Filter": {
"FilteredStatus": "OPT_IN",
"TopicFilter": {
"TopicName": "Cycling",
"UseDefaultIfPreferenceUnavailable": true
}
},
"PageSize": 50
}
```
`FilteredStatus` zeigt den Abonnementstatus an, auf den Sie filtern möchten, der entweder `OPT_IN`oder `OPT_OUT` ist.
`TopicFilter` ist ein optionaler Filter, der angibt, für welches Thema Sie Ergebnisse wünschen. Im obigen Beispiel ist das „*Radfahren*“.
`UseDefaultIfPreferenceUnavailable` kann den Wert `true` oder `false` aufweisen. Wenn`true`, wird die Standardeinstellung des Themas verwendet, wenn der Kontakt keine explizite Präferenz für ein Thema hat. Wenn`false`auswählen, werden nur Kontakte mit einer explizit festgelegten Voreinstellung für die Filterung berücksichtigt.
1. **E-Mail mit `ListManagementOptions` aktiviert senden** – nachdem Sie die Kontakte in Ihrer Liste mit der oben genannten [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)-Operation aufgelistet haben, können Sie mit der [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)-Operation E-Mails an jeden Ihrer Kontakte senden, indem Sie den [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html)-Header verwenden, um Ihre Kontaktliste und Ihren Themennamen anzugeben.
Wenn Sie `ListManagementOptions` mit der `SendEmail`-Operation verwenden möchten, schließen Sie [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) und [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) zu der die E-Mail gehört (der `topicName` ist optional) ein:
```
ListManagementOptions:
String contactListName
String topicName
```
Wenn Sie `ListManagementOptions` in Ihre `SendEmail`-Anfrage an eine Empfänger-E-Mail-Adresse einfügen, die nicht in Ihrer Kontaktliste enthalten ist, wird automatisch ein Kontakt in Ihrer Liste erstellt.
SES gibt ein Bounce-Ereignis für eine Nachricht aus, die an einen Kontakt auf Ihrer Kontaktliste gesendet wird, der sich nicht angemeldet hat. Das bedeutet, dass Sie Ihre `SendEmail` Anfragen nicht aktualisieren müssen, um zu vermeiden, dass sie an Kontakte gesendet werden, die sich abgemeldet haben.
1. **Geben Sie den Speicherort für Ihre Abmeldelinks** an — Wenn Sie diese Option verwenden, haben [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html)Sie die Möglichkeit, SES zu ermöglichen, Ihrer E-Mail Fußzeilenlinks zum Abbestellen hinzuzufügen. Verwenden Sie dazu den `{{amazonSESUnsubscribeUrl}}` Platzhalter, um anzugeben, wo SES die Abmelde-URL einfügen muss. Der Austausch von Platzhaltern wird nur für HTML- und TEXT-Typen unterstützt. Sie können den Platzhalter maximal zwei Mal einschließen. Bei mehrfacher Verwendung werden nur die ersten beiden Vorkommen ersetzt. Weitere Informationen finden Sie unter [Abonnementverwaltung](sending-email-subscription-management.md).
Sie können aber auch den `X-SES-LIST-MANAGEMENT-OPTIONS`-Header verwenden, um beim Senden von E-Mails über die SMTP-Schnittstelle eine Liste und einen Themennamen anzugeben.
Um beim Senden von E-Mails über die SMTP-Schnittstelle eine Liste und ein Thema anzugeben, fügen Sie der Nachricht den folgenden E-Mail-Header hinzu:
`X-SES-LIST-MANAGEMENT-OPTIONS: {contactListName}; topic={topicName}`