文件Experience Platform進階資料生命週期管理指南

[Beta]{class="badge informative"} [Beta]{class="badge informative"}

工單端點 work-order-endpoint

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員

此 /workorder 資料衛生API中的端點可讓您以程式設計方式管理Adobe Experience Platform中的記錄刪除請求。

IMPORTANT
記錄刪除功能目前在Beta版中提供，且僅適用於 限量發行. 並非所有客戶都可使用。 記錄刪除請求僅適用於有限版本中的組織。
記錄刪除旨在用於資料清理、匿名資料移除或資料最小化。 它們是 非 用於資料主體權利要求（法規遵循），如一般資料保護規範(GDPR)等隱私權法規。 對於所有合規性使用案例，請使用 Adobe Experience Platform Privacy Service 而非。

快速入門

本指南中使用的端點屬於資料衛生API。 在繼續之前，請檢閱 概述 如需相關檔案的連結，請參閱本檔案範例API呼叫的指南，以及有關成功呼叫任何Experience PlatformAPI所需標題的重要資訊。

建立記錄刪除請求 create

您可以透過向發出POST請求，從單一資料集或所有資料集中刪除一或多個身分 /workorder 端點。

IMPORTANT
每個月可提交的不重複身分記錄刪除總數有不同的限制。 這些限制是以您的授權合約為基礎。 已購買Adobe Real-time Customer Data Platform和Adobe Journey Optimizer所有版本的組織，每個月最多可提交100,000筆身分記錄刪除。 已購買的組織 AdobeHealthcare Shield 或 Adobe隱私權與安全防護板 每月最多可提交600,000筆身分記錄刪除。
單一 透過UI記錄刪除請求 可讓您一次提交10,000個ID。 用於刪除記錄的API方法允許一次提交100,000個ID。
最佳實務是每個請求提交儘可能多的ID，以您的ID限製為上限。 當您要刪除大量ID時，應避擴音交小量ID或每個記錄刪除請求使用一個單一ID。

API格式

POST /workorder
NOTE
資料生命週期請求只能根據主要身分或身分對應修改資料集。 要求必須指定主要身分，或提供身分對應。

要求

根據 datasetId API呼叫會從您指定的所有資料集或單一資料集中刪除身分。 以下請求會從特定資料集中刪除三個身分。

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 用於記錄刪除。
datasetId
如果您要從單一資料集中刪除，此值必須是相關資料集的ID。 如果您要從所有資料集中刪除，請將值設為 ALL.

如果您指定單一資料集，該資料集的相關聯Experience Data Model (XDM)結構描述必須定義主要身分。 如果資料集沒有主要身分，則必須有身分對應，資料生命週期請求才能修改資料集。
如果身分對應存在，則會顯示為名為的頂層欄位 identityMap.
請注意，資料集列的身分對應中可能有許多身分，但只能將一個標示為主要身分。 "primary": true 必須包含以強制 id 以比對主要身分。
displayName
記錄刪除請求的顯示名稱。
description
記錄刪除請求的說明。
identities

陣列，包含您要刪除其資訊之至少一個使用者的身分識別。 每個身分都由 身分名稱空間 和一個值：

  • namespace：包含單一字串屬性， code，代表身分名稱空間。
  • id：身分值。

如果 datasetId 會指定單一資料集，底下的每個實體 identities 必須使用與結構描述的主要身分相同的身分名稱空間。

如果 datasetId 設為 ALL，則 identities 陣列不受限於任何單一名稱空間，因為每個資料集可能不同。 不過，您的請求仍受限於貴組織可用的名稱空間，如報告所述 Identity Service.

回應

成功的回應會傳回記錄刪除的詳細資料。

{
  "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
刪除順序的ID。 這可用於稍後查詢刪除狀態。
orgId
您的組織ID。
bundleId
與此刪除順序相關聯的套件組合ID，用於偵錯。 多個刪除訂單會整合在一起，由下游服務處理。
action
工單正在執行的動作。 對於記錄刪除，值為 identity-delete.
createdAt
建立刪除順序時的時間戳記。
updatedAt
上次更新刪除順序的時間戳記。
status
刪除順序的目前狀態。
createdBy
建立刪除訂單的使用者。
datasetId
受限於請求的資料集的ID。 如果請求是針對所有資料集，則值將設為 ALL.

擷取記錄刪除的狀態 lookup

在您之後 建立記錄刪除請求，您可使用GET要求來檢查其狀態。

API格式

GET /workorder/{WORK_ORDER_ID}
參數
說明
{WORK_ORDER_ID}
此 workorderId 您正在查詢的記錄刪除專案。

要求

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}'

回應

成功的回應會傳回刪除操作的詳細資訊，包括其目前狀態。

{
  "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
刪除順序的ID。 這可用於稍後查詢刪除狀態。
orgId
您的組織ID。
bundleId
與此刪除順序相關聯的套件組合ID，用於偵錯。 多個刪除訂單會整合在一起，由下游服務處理。
action
工單正在執行的動作。 對於記錄刪除，值為 identity-delete.
createdAt
建立刪除順序時的時間戳記。
updatedAt
上次更新刪除順序的時間戳記。
status
刪除順序的目前狀態。
createdBy
建立刪除訂單的使用者。
datasetId
受限於請求的資料集的ID。 如果請求是針對所有資料集，則值將設為 ALL.
productStatusDetails

一個陣列，列出與請求相關的下游處理序的目前狀態。 每個陣列物件包含下列屬性：

  • productName：下游服務的名稱。
  • productStatus：下游服務請求的目前處理狀態。
  • createdAt：服務發佈最新狀態的時間戳記。

更新記錄刪除請求

您可以更新 displayName 和 description 刪除記錄(透過提出PUT請求)。

API格式

PUT /workorder{WORK_ORDER_ID}
參數
說明
{WORK_ORDER_ID}
此 workorderId 您正在查詢的記錄刪除專案。

要求

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
記錄刪除請求的更新說明。

回應

成功的回應會傳回記錄刪除的詳細資料。

{
  "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" : "Update - displayName",
  "description" : "Update - description",
  "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
刪除順序的ID。 這可用於稍後查詢刪除狀態。
orgId
您的組織ID。
bundleId
與此刪除順序相關聯的套件組合ID，用於偵錯。 多個刪除訂單會整合在一起，由下游服務處理。
action
工單正在執行的動作。 對於記錄刪除，值為 identity-delete.
createdAt
建立刪除順序時的時間戳記。
updatedAt
上次更新刪除順序的時間戳記。
status
刪除順序的目前狀態。
createdBy
建立刪除訂單的使用者。
datasetId
受限於請求的資料集的ID。 如果請求是針對所有資料集，則值將設為 ALL.
productStatusDetails

一個陣列，列出與請求相關的下游處理序的目前狀態。 每個陣列物件包含下列屬性：

  • productName：下游服務的名稱。
  • productStatus：下游服務請求的目前處理狀態。
  • createdAt：服務發佈最新狀態的時間戳記。
recommendation-more-help
332f81c1-51e7-4bde-8327-2eb07f09604f