同意エンドポイント
特定の規制では、個人データを収集する前に、顧客の明示的な同意が必要です。 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 で認識される 標準 ID 名前空間の 1 つが含まれている必要があります。values
指定された
nameSpace
に対応する、各ユーザーの値の配列。NOTE
Privacy Service に送信する顧客 ID 値を決定する方法について詳しくは、ID データの提供に関するガイドを参照してください。
応答
応答が成功すると、ペイロードのない HTTP ステータス 202 (許可済み)が返され、リクエストが Privacy Service によって受け入れられ、処理中であることを示します。
recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580