同意端點

特定法規要求客戶明確同意才能收集其個人資料。 Privacy Service API中的/consent端點可讓您處理客戶同意要求,並將這些要求整合至您的隱私權工作流程。

使用本指南之前,請參閱快速入門指南,以取得有關以下範例API呼叫中所需驗證標頭的資訊。

處理客戶同意請求

同意要求是透過向/consent端點發出POST要求來處理。

API格式

POST /consent

要求

下列要求會針對entities陣列中提供的使用者ID建立新的同意工作。

curl -X POST \
  https://platform.adobe.io/data/core/privacy/consent \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
        "optOutOfSale": true,
        "entities": [
          {
            "nameSpace": "email",
            "values": [
              "dsmith@acme.com",
              "ajones@acme.com"
            ]
          },
          {
            "nameSpace": "ECID",
            "values": [
              "443636576799758681021090721276"
            ]
          }
        ]
      }'
屬性
說明
optOutOfSale
若設為true,表示在entities底下提供的使用者希望退出銷售或分享其個人資料。
entities
表示同意要求套用至的使用者的物件陣列。 每個物件包含一個namespace和一個values陣列,以比對具有該名稱空間的個別使用者。
nameSpace
entities陣列中的每個物件都必須包含Privacy ServiceAPI可辨識的標準身分名稱空間之一。
values
每個使用者的值陣列,對應提供的nameSpace
NOTE
如需如何判斷要傳送給Privacy Service之客戶身分值的詳細資訊,請參閱提供身分資料的指南。

回應

成功的回應傳回HTTP狀態202 (已接受),沒有承載,表示Privacy Service已接受要求且正在處理。

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