同意エンドポイント
特定の規制では、個人データを収集する前に、顧客からの明示的な同意を求めています。 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"
]
}
]
}'
プロパティ
説明
optOutOfSaletrueに設定すると、
entitiesで提供されたユーザーが、個人データの販売または共有をオプトアウトすることを希望することを示します。entities同意リクエストが適用されるユーザーを示すオブジェクトの配列。 各オブジェクトには、個々のユーザーとその名前空間を一致させる
namespaceとvaluesの配列が含まれています。nameSpaceentities配列内の各オブジェクトには、Privacy Service APIによって認識される標準ID名前空間のいずれかが含まれている必要があります。values指定された
nameSpaceに対応する、各ユーザーの値の配列。NOTE
Privacy Serviceに送信する顧客ID値を決定する方法について詳しくは、ID データの提供に関するガイドを参照してください。
応答
応答が成功すると、HTTP ステータス 202 （Accepted）がペイロードなしで返され、リクエストがPrivacy Serviceによって受け入れられ、処理中であることを示します。
recommendation-more-help
experience-platform-help-privacy-service