文件Experience PlatformPrivacy Service 指南

內容端點

Last update: Mon Jan 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

使用/content端點安全地擷取您客戶的​ 存取資訊 （隱私權主體可以合法要求存取的資訊）。 回應/jobs/{JOB_ID}GET要求時提供的下載URL指向Adobe服務端點。 然後，您可以向/jobs/:JOB_ID/content發出GET請求，以JSON格式傳回您的客戶資料。 此存取方法實作多層驗證和存取控制以增強安全性。

使用本指南之前，請參閱快速入門手冊，瞭解下列範例API呼叫中所需驗證標頭的資訊。

TIP
如果您目前不知道所需存取資訊的作業ID，請呼叫/jobs端點，並使用其他查詢引數來篩選結果。 您可以在隱私權工作端點指南中找到可用查詢引數的完整清單。

擷取隱私工作資訊

若要擷取特定工作的相關資訊，例如其目前的處理狀態，請將該工作的jobId包含在/jobs端點的GET要求路徑中。

API格式

GET /jobs/{JOB_ID}

要求

下列請求會擷取其請求路徑中提供jobId之工作的詳細資料。

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}'

回應

成功的回應會傳回指定工作的詳細資訊。

NOTE
隱私權工作必須具有complete狀態才能包含downloadUrl。
{
    "jobId":"dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5",
    "requestId":"17129380910360540RX-753",
    "userKey":"1234",
    "action":"access",
    "status":"complete",
    "submittedBy":"jsnow@adobe.com",
    "createdDate":"04/12/2024 04:08 PM GMT",
    "lastModifiedDate":"04/12/2024 04:08 PM GMT",
    "userIds":[{
        "namespace":"ECID",
        "value":"1234",
        "type":"standard",
        "namespaceId":4,
        "isDeletedClientSide":false
        }],
    "productResponses":[{
        "product":"Identity",
        "retryCount":0,
        "processedDate":"04/12/2024 04:08 PM GMT",
        "productStatusResponse":{"status":"submitted"
        }}],
    "downloadUrl":"https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5/content",
    "regulation":"gdpr"
}
屬性
說明
jobId
隱私權工作的唯一識別碼。
requestId
向Privacy Service提出之特定要求的唯一識別碼。
userKey
userKey是您在提交隱私權請求時提供的key值。 key值是您提供資料主體識別碼的機會，這對您有意義。 這通常是您的系統為追蹤該資料主體而建立的唯一識別碼。 秘訣：您可以列出所有作用中的隱私權工作，並將您的key與每個工作進行比較。
action
要求的動作型別。 接受的值為access和delete。
status
隱私權工作的目前狀態。
submittedBy
提交隱私權工作之人員的電子郵件地址。
createdDate
隱私權工作的建立日期和時間。
lastModifiedDate
上次修改隱私權工作的日期與時間。
userIds
包含使用者識別碼和相關資訊的陣列。
userIds.namespace
用於使用者識別碼的名稱空間。
userIds.value
使用者識別碼的實際值。
userIds.type
識別碼的型別（例如standard或custom）。
userIds.namespaceId
用來分類和管理使用者身分的名稱空間識別碼。
userIds.isDeletedClientSide
表示識別碼在使用者端是否已刪除的布林值。
productResponses
一個陣列，包含與隱私權工作相關的不同產品或服務的回應。
productResponses.product
用來取得資料主體資訊的產品或服務名稱。
productResponses.retryCount
重試請求的次數。
productResponses.processedDate
處理產品回應的日期和時間。
productResponses.productStatusResponse
包含產品回應狀態的物件。
productResponses.productStatusResponse.status
產品回應的狀態。
downloadURL
此屬性會提供端點，可在工作完成後的60天內呼叫。 工作的狀態必須是complete，action必須是access。 否則，此欄位不存在。
regulation
正在處理隱私權要求的法規架構，例如gdpr、ccpa、lgpd_bra、pdpa_tha等。

擷取客戶存取資訊 retrieve-access-data

若要取得回應您資料主體查詢而產生的「存取資訊」，請對/jobs/{JOB_ID}/content端點提出GET要求。 回應為zip檔案(*.zip)，其中包含資料夾，每個產品都有子資料夾，其中包含資料主體的資料。

TIP
您需要特定工作ID才能提出此請求。 如果您需要擷取特定作業ID，請先對/jobs端點提出GET要求，並使用其他查詢引數來篩選結果。 您可以在隱私權工作端點指南中找到包含允許查詢引數的詳細資訊。

API格式

GET /jobs/{JOB_ID}/content

要求

以下請求會針對請求中提供的作業ID傳回「存取資訊」。

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/32d429b1-f7f4-11ee-a365-574bcf5a525d/content \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Accept: application/json`

回應

回應為zip檔案(*.zip)。 雖然無法保證此資訊，但通常會以JSON格式傳回。 擷取的資料可以任何格式傳回。

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580