[Beta]{class="badge informative"} [Beta]{class="badge informative"}
Arbeitsauftrags-Endpunkt work-order-endpoint
Die /workorder
-Endpunkt in der Data Hygiene-API ermöglicht es Ihnen, Löschanfragen von Datensätzen in Adobe Experience Platform programmgesteuert zu verwalten.
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.
Datensatzlöschanfrage erstellen create
Sie können eine oder mehrere Identitäten aus einem Datensatz oder allen Datensätzen löschen, indem Sie eine POST-Anfrage an die /workorder
-Endpunkt.
Ein Löschanfrage über die Benutzeroberfläche aufzeichnen ermöglicht die gleichzeitige Übermittlung von 10.000 IDs. Die API-Methode zum Löschen von Datensätzen ermöglicht die gleichzeitige Übermittlung von 100.000 IDs.
Es empfiehlt sich, bis zu Ihrer ID-Grenze so viele IDs pro Anfrage wie möglich zu senden. Wenn Sie eine große Anzahl von IDs löschen möchten, sollte vermieden werden, ein geringes Volumen oder eine einzelne ID pro Datensatz-Löschanfrage zu senden.
API-Format
POST /workorder
Anfrage
Abhängig vom Wert der Variablen datasetId
in der Anfrage-Payload angegeben wird, löscht der API-Aufruf Identitäten aus allen Datensätzen oder einem einzelnen Datensatz, den Sie angeben. 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"
}
]
}'
action
delete_identity
zum Löschen von Datensätzen.datasetId
ALL
.Wenn Sie einen einzelnen Datensatz angeben, muss das zugeordnete Experience-Datenmodell (XDM)-Schema des Datensatzes über eine primäre Identität verfügen. 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, wird sie als Feld der obersten Ebene mit dem Namen
identityMap
.Beachten Sie, dass eine Datensatzzeile in ihrer Identitätszuordnung zwar viele Identitäten aufweisen kann, jedoch nur eine als primär markiert werden kann.
"primary": true
muss enthalten sein, um die id
, um eine primäre Identität zuzuordnen.displayName
description
identities
Ein 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 Löschvorgangs des Datensatzes 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."
}
workorderId
orgId
bundleId
action
identity-delete
.createdAt
updatedAt
status
createdBy
datasetId
ALL
gesetztStatus eines Datensatzlöschens abrufen lookup
Nach Löschanfrage für Datensätze erstellenkönnen Sie den Status mit einer GET-Anfrage überprüfen.
API-Format
GET /workorder/{WORK_ORDER_ID}
{WORK_ORDER_ID}
workorderId
des Datensatzes löschen, den Sie nachschlagen.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"
}
]
}
workorderId
orgId
bundleId
action
identity-delete
.createdAt
updatedAt
status
createdBy
datasetId
ALL
gesetztproductStatusDetails
Array, 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 von Löschanfragen für Datensätze
Sie können die displayName
und description
für einen Datensatz löschen, indem Sie eine PUT-Anfrage stellen.
API-Format
PUT /workorder{WORK_ORDER_ID}
{WORK_ORDER_ID}
workorderId
des Datensatzes löschen, den Sie nachschlagen.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"
}'
displayName
description
Antwort
Eine erfolgreiche Antwort gibt die Details des Löschvorgangs des Datensatzes 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"
}
]
}
workorderId
orgId
bundleId
action
identity-delete
.createdAt
updatedAt
status
createdBy
datasetId
ALL
gesetztproductStatusDetails
Array, 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.