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 der API von Amazon Connect Customer Profiles
Informationen zur programmgesteuerten Verwaltung von Domains und Profilen finden Sie in der [Amazon-Connect-Customer-Profiles-API-Referenz](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ListObjectTypeAttributeValues API
Die ListObjectTypeAttributeValues API bietet Zugriff auf die neuesten eindeutigen Werte für jedes angegebene Attribut, was sie für die Datenvalidierung und Konsistenzprüfungen innerhalb Ihrer Objekttypen in Echtzeit nützlich macht. Diese API funktioniert domänenübergreifend und unterstützt sowohl benutzerdefinierte als auch Standardobjekttypen. Die API akzeptiert den Objekttypnamen, den Attributnamen und den Domänennamen als Eingabeparameter und gibt Werte bis zum Speicherlimit von ca. 350 KB zurück.
**Hinweis:**
+ Wir speichern bis zu 350 KB an Attributwerten pro Feld, wobei die neuesten Werte zuerst priorisiert werden. Sobald dieses Limit erreicht ist, werden ältere Werte automatisch entfernt, um Platz für neue Einträge zu schaffen.
## GetObjectTypeAttributeValues API
Die GetObjectTypeAttributeValues API liefert statistische Erkenntnisse über Attribute innerhalb eines bestimmten Objekttyps, ist jedoch ausschließlich für Domänen mit aktiviertem Datenspeicher verfügbar. Diese API führt tägliche Berechnungen durch, um statistische Informationen über Ihre Attributwerte bereitzustellen und Ihnen zu helfen, Muster und Trends in Ihren Daten zu verstehen. Die statistischen Berechnungen werden einmal täglich durchgeführt und bieten so eine konsistente Momentaufnahme Ihrer Attributdateneigenschaften.
**Hinweis:**
+ In zwei Szenarien erhalten Sie Nullwerte:
+ In der ersten Zeit nach der Aktivierung des Datentresors (sofern kein Berechnungszyklus stattfindet, der einmal täglich stattfindet).
+ Für Attribute, die keine numerischen Werte enthalten.
Wir empfehlen, die CustomerProfile JS-Open-Source-Bibliothek zu verwenden, wenn Sie Kundenprofile in Ihre eigene Agentenanwendung integrieren. Weitere Informationen finden Sie im CustomerProfiles JS-Repo auf [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles).
Weitere Informationen zur Integration Ihrer vorhandenen Apps mit Amazon Connect finden Sie unter [Amazon-Connect-Streams](https://github.com/aws/amazon-connect-streams). Sie können die Komponenten des CCP (Contact Control Panel) in die App einbetten.
# Grundlegendes zum IPv6 Support in Amazon Connect Connect-Kundenprofilen
## Öffentliche Verbindungen
Alle Amazon Connect Connect-Kundenprofile unterstützen IPv4 und IPv6 rufen APIs vollständig an.
```
profile.Region.api.aws
```
**Beispiel**:
```
profile.us-east-1.api.aws
```
Für die AWS-CLI müssen Sie explizit diese Endpunkte verwenden:
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
Die alten APIs sind weiterhin als Abwärtskompatibilität verfügbar. Sie unterstützen nur IPv4 Anrufe.
```
profile.Region.amazonaws.com
```
**Beispiel**:
```
profile.us-east-1.amazonaws.com
```
## Private Verbindungen
Sie können einen VPC-Endpunkt für die API von Amazon Connect Customer Profiles mithilfe der Amazon VPC-Konsole oder der AWS Command Line Interface (AWS CLI) erstellen. Weitere Informationen finden Sie im PrivateLink AWS-Handbuch unter [Erstellen eines Schnittstellenendpunkts](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html).
Erstellen Sie einen VPC-Endpunkt für Amazon Connect Customer Profiles mit dem folgenden Servicenamen:
```
com.amazonaws.Region.profile
```
**Beispiel**:
```
com.amazonaws.us-east-1.profile
```
Wenn Sie privates DNS für den Endpunkt aktivieren, können Sie API-Anfragen an Amazon Connect Connect-Kundenprofile stellen, indem Sie dessen IPv4 und den IPv6 unterstützten DNS-Namen für die Region verwenden, z. B. profile.us-east-1.api.aws.
Alternativ wird der alte DNS-Name für die Region auch als „Nur“ unterstützt. IPv4
**Beispiel**:
```
profile.us-east-1.amazonaws.com
```
# Beispiel: Programmgesteuerte Integration von S3 in Amazon Connect Customer Profiles
Mithilfe der [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)Kundenprofil-API können Sie programmgesteuert Integrationen für S3, Salesforce, Marketo und mehr erstellen.
In diesem Thema erfahren Sie, wie Sie eine S3-Integration mit einem Synch-Intervall von 15 Minuten erstellen, dem derzeit unterstützten Mindestwert.
## Schritt 1: Erstellen einer JSON-Datei
Erstellen Sie eine JSON-Datei mit folgendem Inhalt:
```
{
"DomainName": "your-domain",
"ObjectTypeName": "your-object-name",
"FlowDefinition": {
"FlowName": "your-flow-name",
"KmsArn": "the key ARN is the same as your domain's key",
"Description": "Created by Customer Profiles",
"TriggerConfig": {
"TriggerType": "Scheduled",
"TriggerProperties": {
"Scheduled": {
"ScheduleExpression": "rate(15minutes)",
"DataPullMode": "Incremental",
"ScheduleStartTime": 1634244800.435,
"FirstExecutionFrom": 1594166400
}
}
},
"SourceFlowConfig": {
"ConnectorType":"S3",
"SourceConnectorProperties": {
"S3": {
"BucketName": "your-bucket",
"BucketPrefix": "your-prefix"
}
}
},
"Tasks": [
{"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
]
}
}
```
Beachten Sie die folgenden Richtlinien, wenn Sie die JSON-Datei mit Ihren eigenen Werten anpassen möchten:
+ `FlowName`: z. B. STRING [a-zA-Z0-9][\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime`: Auf die aktuelle Epochenzeit von `DateTime` \$1 5 Minuten eingestellt.
+ `FirstExecutionFrom`: Öffnen Sie S3, sehen Sie sich das Dateidatum an und verwenden Sie ein Datum, das vor dem ältesten Datum liegt.
+ `Tasks`: `TaskType` definieren. Im `Sourcefields`-Feld müssen ALLE Spalten angegeben werden, die Sie in diesem Array in Ihrer CSV haben. Anschließend müssen Sie für jedes der Elemente in diesem Array `ConnectorOperator` angeben. Dieses Beispiel bezieht sich auf ein CSV-Dokument mit zwei Spalten: `colA` und `colB`.
## Schritt 2: Rufen Sie die API auf PutIntegration
Nachdem Sie die JSON-Datei mit Ihren Werten erstellt und angepasst haben, rufen Sie die [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API auf, wie im folgenden Beispiel gezeigt:
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
Die Antwort von `PutIntegration` gibt einen Flow-URI zurück. Beispiel:
```
{
"DomainName": "testDomain",
"Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
"ObjectTypeName": "your objec type",
"CreatedAt": "2021-10-14T13:51:57.748000-07:00",
"LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
"Tags": {}
}
```
## Schritt 3: Rufen Sie die AppFlow StartFlow Amazon-API auf
Verwenden Sie den Flow-URI, um die AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)Amazon-API aufzurufen. Beispiel:
```
aws appflow start-flow —flow-name uri --region us-west-2
```