Beta Beta
Arbeitsauftrags-Endpunkt
31. Dezember 2024
- Themen:
- Datenhygiene
Erstellt für:
- Entwickler
Mit dem /workorder-Endpunkt in der Data Hygiene API können Sie Anfragen zum Löschen von Datensätzen in Adobe Experience Platform programmgesteuert verwalten.
IMPORTANTDie Funktion zum Löschen von Datensätzen befindet sich derzeit in Beta und ist nur in einer Version. Sie steht nicht allen Kunden zur Verfügung. Löschanfragen für Datensätze sind nur für Organisationen in der eingeschränkten Version verfügbar.
Löschvorgänge von Datensätzen dienen zur Datenbereinigung, zum Entfernen anonymer Daten oder zur Datenminimierung. Sie dürfen nicht für Anfragen zu den Rechten der betroffenen Personen (Compliance) verwendet werden, da sie sich auf Datenschutzbestimmungen wie die Datenschutz-Grundverordnung (DSGVO) beziehen. Verwenden Sie stattdessen Adobe Experience Platform Privacy Service für alle Compliance-Anwendungsfälle.
Erste Schritte
Der in diesem Handbuch verwendete Endpunkt ist Teil der Data Hygiene API. Bevor Sie fortfahren, lesen Sie die Übersicht mit Links zur zugehörigen Dokumentation, einer Anleitung zum Lesen der API-Beispielaufrufe in diesem Dokument und wichtigen Informationen zu den Kopfzeilen, die für die erfolgreiche Ausführung von Aufrufen an eine Experience Platform-API erforderlich sind.
Erstellen einer Anfrage zum Löschen eines Datensatzes
Sie können eine oder mehrere Identitäten aus einem einzelnen Datensatz oder allen Datensätzen löschen, indem Sie eine POST-Anfrage an den /workorder-Endpunkt stellen.
IMPORTANTEs gibt verschiedene Beschränkungen für die Gesamtzahl der Löschvorgänge von eindeutigen Identitätsdatensätzen, die jeden Monat gesendet werden können. Diese Beschränkungen basieren auf Ihrer Lizenzvereinbarung. Organisationen, die alle Editionen von Adobe Real-time Customer Data Platform und Adobe Journey Optimizer erworben haben, können monatlich bis zu 100.000 Identitätseintragslöschungen übermitteln. Organisationen, die Adobe Healthcare Shield oder Adobe Privacy & Security Shield erworben haben, können monatlich bis zu 600.000 Identitätseinträge löschen.
Mit einer einzigen Löschanfrage für Datensätze über die Benutzeroberfläche können Sie 10.000 IDs gleichzeitig senden. Die API-Methode zum Löschen von Datensätzen ermöglicht die gleichzeitige Übermittlung von 100.000 IDs.
Es empfiehlt sich, so viele IDs wie möglich pro Anfrage bis zu Ihrem ID-Limit zu senden. Wenn Sie eine große Anzahl von IDs löschen möchten, sollten Sie die Übermittlung einer geringen Anzahl oder einer einzelnen ID pro Löschanfrage für den Datensatz vermeiden.
Mit einer einzigen Löschanfrage für Datensätze über die Benutzeroberfläche können Sie 10.000 IDs gleichzeitig senden. Die API-Methode zum Löschen von Datensätzen ermöglicht die gleichzeitige Übermittlung von 100.000 IDs.
Es empfiehlt sich, so viele IDs wie möglich pro Anfrage bis zu Ihrem ID-Limit zu senden. Wenn Sie eine große Anzahl von IDs löschen möchten, sollten Sie die Übermittlung einer geringen Anzahl oder einer einzelnen ID pro Löschanfrage für den Datensatz vermeiden.
API-Format
POST /workorder
NOTEDatenlebenszyklusanfragen können nur Datensätze ändern, die auf primären Identitäten oder einer Identitätszuordnung basieren. Eine Anfrage muss entweder die primäre Identität angeben oder eine Identitätszuordnung bereitstellen.
Anfrage
Abhängig vom Wert der datasetId in der Anfrage-Payload löscht der API-Aufruf Identitäten aus allen Datensätzen oder einem einzelnen von Ihnen angegebenen Datensatz. Die folgende Anfrage löscht drei Identitäten aus einem bestimmten Datensatz.
curl -X POST \
https://platform.adobe.io/data/core/hygiene/workorder \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'Content-Type: application/json' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"action": "delete_identity",
"datasetId": "c48b51623ec641a2949d339bad69cb15",
"displayName": "Example Record Delete Request",
"description": "Cleanup identities required by Jira request 12345.",
"identities": [
{
"namespace": {
"code": "email"
},
"id": "poul.anderson@example.com"
},
{
"namespace": {
"code": "email"
},
"id": "cordwainer.smith@gmail.com"
},
{
"namespace": {
"code": "email"
},
"id": "cyril.kornbluth@yahoo.com"
}
]
}'
Eigenschaft
Beschreibung
actionDie auszuführende Aktion. Für das Löschen von Datensätzen muss der Wert auf
delete_identity festgelegt werden.datasetIdWenn Sie Identitäten aus einem einzelnen Datensatz löschen, muss dieser Wert die Kennung des betreffenden Datensatzes sein. Wenn Sie Identitäten aus allen Datensätzen löschen, setzen Sie den Wert auf
Wenn Sie einen einzelnen Datensatz angeben, muss für das zugeordnete Experience-Datenmodell-Schema (XDM) des Datensatzes eine primäre Identität definiert sein. Wenn der Datensatz keine primäre Identität hat, muss er über eine Identitätszuordnung verfügen, damit er durch eine Data-Lifecycle-Anfrage geändert werden kann.
Wenn eine Identitätszuordnung vorhanden ist, ist sie als Feld der obersten Ebene mit dem Namen
Beachten Sie, dass eine Datensatzzeile viele Identitäten in ihrer Identitätszuordnung haben kann, aber nur eine als primär markiert werden kann.
ALL.Wenn Sie einen einzelnen Datensatz angeben, muss für das zugeordnete Experience-Datenmodell-Schema (XDM) des Datensatzes eine primäre Identität definiert sein. Wenn der Datensatz keine primäre Identität hat, muss er über eine Identitätszuordnung verfügen, damit er durch eine Data-Lifecycle-Anfrage geändert werden kann.
Wenn eine Identitätszuordnung vorhanden ist, ist sie als Feld der obersten Ebene mit dem Namen
identityMap vorhanden.Beachten Sie, dass eine Datensatzzeile viele Identitäten in ihrer Identitätszuordnung haben kann, aber nur eine als primär markiert werden kann.
"primary": true müssen eingeschlossen werden, damit der id mit einer primären Identität übereinstimmt.displayNameDer Anzeigename für die Löschanfrage des Datensatzes.
descriptionEine Beschreibung für den Antrag auf Löschung eines Datensatzes.
identitiesEin Array mit den Identitäten von mindestens einem Benutzer, dessen Informationen Sie löschen möchten. Jede Identität besteht aus einem Identity-Namespace und einem Wert:
namespace: enthält die einzige Zeichenfolgen-Eigenschaftcode, die den Identity-Namespace darstellt.id: der Identitätswert.
Wenn datasetId einen einzelnen Datensatz spezifiziert, muss jede Entität unter identities denselben Identity-Namespace wie die primäre Identität des Schemas verwenden.
Wenn datasetId auf ALL festgelegt ist, ist das identities-Array nicht auf einen einzigen Namespace beschränkt, da jeder Datensatz anders sein kann. Ihre Anfragen sind aber auf die Namespaces beschränkt, die Ihrer Organisation zur Verfügung stehen, wie von Identity Service spezifiziert.
Antwort
Eine erfolgreiche Antwort gibt die Details des Datensatzlöschvorgangs zurück.
{
"workorderId": "a15345b8-a2d6-4d6f-b33c-5b593e86439a",
"orgId": "{ORG_ID}",
"bundleId": "BN-35c1676c-3b4f-4195-8d6c-7cf5aa21efdd",
"action": "identity-delete",
"createdAt": "2022-07-21T18:05:28.316029Z",
"updatedAt": "2022-07-21T17:59:43.217801Z",
"status": "received",
"createdBy": "{USER_ID}",
"datasetId": "c48b51623ec641a2949d339bad69cb15",
"displayName": "Example Record Delete Request",
"description": "Cleanup identities required by Jira request 12345."
}
Eigenschaft
Beschreibung
workorderIdDie ID des Löschauftrags. Diese kann verwendet werden, um den Status des Löschvorgangs später anzuzeigen.
orgIdIhre Organisations-ID.
bundleIdID des Pakets, dem dieser Löschauftrag zugeordnet ist. Sie wird zur Fehlerbehebung verwendet. Mehrere Löschaufträge werden zu einem Paket zusammengefasst, das von nachgelagerten Services verarbeitet wird.
actionAktion, die bei dem Arbeitsauftrag ausgeführt wird. Beim Löschen von Datensätzen ist der Wert
identity-delete.createdAtZeitstempel, der angibt, wann der Löschauftrag erstellt wurde.
updatedAtZeitstempel, der angibt, wann der Löschauftrag zuletzt aktualisiert wurde.
statusDer aktuelle Status des Löschauftrags.
createdByDer Benutzer, der den Löschauftrag erstellt hat.
datasetIdID des Datensatzes, der Gegenstand der Anfrage ist. Wenn die Anfrage alle Datensätze betrifft, wird der Wert auf
ALL gesetztAbrufen des Status einer Datensatzlöschung
Nachdem Sie eine Anfrage zum Löschen eines Datensatzes erstellt können Sie den Status mit einer GET-Anfrage überprüfen.
API-Format
GET /workorder/{WORK_ORDER_ID}
Parameter
Beschreibung
{WORK_ORDER_ID}Die
workorderId des Datensatzlöschens, nach dem Sie suchen.Anfrage
curl -X GET \
https://platform.adobe.io/data/core/hygiene/workorder/BN-35c1676c-3b4f-4195-8d6c-7cf5aa21efdd \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Antwort
Eine erfolgreiche Antwort gibt die Details des Löschvorgangs zurück, einschließlich des aktuellen Status.
{
"workorderId": "a15345b8-a2d6-4d6f-b33c-5b593e86439a",
"orgId": "{ORG_ID}",
"bundleId": "BN-35c1676c-3b4f-4195-8d6c-7cf5aa21efdd",
"action": "identity-delete",
"createdAt": "2022-07-21T18:05:28.316029Z",
"updatedAt": "2022-07-21T17:59:43.217801Z",
"status": "received",
"createdBy": "{USER_ID}",
"datasetId": "c48b51623ec641a2949d339bad69cb15",
"displayName": "Example Record Delete Request",
"description": "Cleanup identities required by Jira request 12345.",
"productStatusDetails": [
{
"productName": "Data Management",
"productStatus": "success",
"createdAt": "2022-08-08T16:51:31.535872Z"
},
{
"productName": "Identity Service",
"productStatus": "success",
"createdAt": "2022-08-08T16:43:46.331150Z"
},
{
"productName": "Profile Service",
"productStatus": "waiting",
"createdAt": "2022-08-08T16:37:13.443481Z"
}
]
}
Eigenschaft
Beschreibung
workorderIdDie ID des Löschauftrags. Diese kann verwendet werden, um den Status des Löschvorgangs später anzuzeigen.
orgIdIhre Organisations-ID.
bundleIdID des Pakets, dem dieser Löschauftrag zugeordnet ist. Sie wird zur Fehlerbehebung verwendet. Mehrere Löschaufträge werden zu einem Paket zusammengefasst, das von nachgelagerten Services verarbeitet wird.
actionAktion, die bei dem Arbeitsauftrag ausgeführt wird. Beim Löschen von Datensätzen ist der Wert
identity-delete.createdAtZeitstempel, der angibt, wann der Löschauftrag erstellt wurde.
updatedAtZeitstempel, der angibt, wann der Löschauftrag zuletzt aktualisiert wurde.
statusDer aktuelle Status des Löschauftrags.
createdByDer Benutzer, der den Löschauftrag erstellt hat.
datasetIdID des Datensatzes, der Gegenstand der Anfrage ist. Wenn die Anfrage alle Datensätze betrifft, wird der Wert auf
ALL gesetztproductStatusDetailsArray, das den aktuellen Status der nachgelagerten Prozesse im Zusammenhang mit der Anfrage auflistet. Jedes Array-Objekt enthält die folgenden Eigenschaften:
productName: Name des nachgelagerten Services.productStatus: Aktueller Verarbeitungsstatus der Anfrage von dem nachgelagerten Service.createdAt: Zeitstempel, der angibt, wann der letzte Status von dem Service veröffentlicht wurde.
Aktualisieren einer Löschanfrage für einen Datensatz
Sie können die displayName und description für eine Datensatzlöschung aktualisieren, indem Sie eine PUT-Anfrage stellen.
API-Format
PUT /workorder{WORK_ORDER_ID}
Parameter
Beschreibung
{WORK_ORDER_ID}Die
workorderId des Datensatzlöschens, nach dem Sie suchen.Anfrage
curl -X PUT \
https://platform.adobe.io/data/core/hygiene/workorder/BN-35c1676c-3b4f-4195-8d6c-7cf5aa21efdd \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"displayName" : "Update - displayName",
"description" : "Update - description"
}'
Eigenschaft
Beschreibung
displayNameEin aktualisierter Anzeigename für die Löschanfrage des Datensatzes.
descriptionEine aktualisierte Beschreibung für die Löschanfrage des Datensatzes.
Antwort
Eine erfolgreiche Antwort gibt die Details des Datensatzlöschvorgangs zurück.
{
"workorderId": "DI-61828416-963a-463f-91c1-dbc4d0ddbd43",
"orgId": "{ORG_ID}",
"bundleId": "BN-aacacc09-d10c-48c5-a64c-2ced96a78fca",
"action": "identity-delete",
"createdAt": "2024-06-12T20:02:49.398448Z",
"updatedAt": "2024-06-13T21:35:01.944749Z",
"operationCount": 1,
"status": "ingested",
"createdBy": "{USER_ID}",
"datasetId": "666950e6b7e2022c9e7d7a33",
"datasetName": "Acme_Dataset_E2E_Identity_Map_Schema_5_1718178022379",
"displayName": "Updated Display Name",
"description": "Updated Description",
"productStatusDetails": [
{
"productName": "Data Management",
"productStatus": "waiting",
"createdAt": "2024-06-12T20:11:18.447747Z"
},
{
"productName": "Identity Service",
"productStatus": "success",
"createdAt": "2024-06-12T20:36:09.020832Z"
},
{
"productName": "Profile Service",
"productStatus": "waiting",
"createdAt": "2024-06-12T20:11:18.447747Z"
},
{
"productName": "Journey Orchestrator",
"productStatus": "success",
"createdAt": "2024-06-12T20:12:19.843199Z"
}
]
}
Eigenschaft
Beschreibung
workorderIdDie ID des Löschauftrags. Diese kann verwendet werden, um den Status des Löschvorgangs später anzuzeigen.
orgIdIhre Organisations-ID.
bundleIdID des Pakets, dem dieser Löschauftrag zugeordnet ist. Sie wird zur Fehlerbehebung verwendet. Mehrere Löschaufträge werden zu einem Paket zusammengefasst, das von nachgelagerten Services verarbeitet wird.
actionAktion, die bei dem Arbeitsauftrag ausgeführt wird. Beim Löschen von Datensätzen ist der Wert
identity-delete.createdAtZeitstempel, der angibt, wann der Löschauftrag erstellt wurde.
updatedAtZeitstempel, der angibt, wann der Löschauftrag zuletzt aktualisiert wurde.
statusDer aktuelle Status des Löschauftrags.
createdByDer Benutzer, der den Löschauftrag erstellt hat.
datasetIdID des Datensatzes, der Gegenstand der Anfrage ist. Wenn die Anfrage alle Datensätze betrifft, wird der Wert auf
ALL gesetztproductStatusDetailsArray, das den aktuellen Status der nachgelagerten Prozesse im Zusammenhang mit der Anfrage auflistet. Jedes Array-Objekt enthält die folgenden Eigenschaften:
productName: Name des nachgelagerten Services.productStatus: Aktueller Verarbeitungsstatus der Anfrage von dem nachgelagerten Service.createdAt: Zeitstempel, der angibt, wann der letzte Status von dem Service veröffentlicht wurde.
recommendation-more-help
332f81c1-51e7-4bde-8327-2eb07f09604f