某些法規要求客戶明確同意才能收集其個人資料。 此 /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 且正在處理中。