同意端點

上次更新: 2023-05-25
  • 主題:
  • Privacy
    檢視有關此主題的更多資訊
  • 建立對象:
  • Developer
    User
    Admin
    Leader

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

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

處理客戶同意請求

處理同意請求的方式為向發出POST請求 /consent 端點。

API格式

POST /consent

要求

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

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.
注意

如需如何判斷要傳送至哪些客戶身分值的詳細資訊 Privacy Service,請參閱以下內容的相關指南: 提供身分資料.

回應

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

本頁內容