Deletes user data originally sourced from the client. The API call rate is limited to 1 transactions per second (TPS). Calls exceeding this rate are throttled. Payload size is limited to 1000 users or 1MB. Calls with a more than 1000 users or 1MB will rec

PATCH

/v2/dp/users

最后修改时间：2026-08-27 23:21:02

责任人：未设置

删除来自数据提供方的用户数据。删除范围可限定为某个广告主，也可为该数据提供方删除全部用户。数据删除的 SLA 为 30 天。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "operation": "DELETE",
    "users": [
        {
            "advertiserId": 205759403805,
            "consentTime": 1581557890000,
            "userId": {
                "type": "COOKIE",
                "value": "EMpBAI0GRcK4nBNGpPGg5g"
            }
        },
        {
            "advertiserId": 305759403805,
            "consentTime": 1581557900000,
            "userId": {
                "type": "COOKIE",
                "value": "EMpBAI0GRcK4nBNGpPGg5g"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://www.amazon.com/ap/oa/v2/dp/users' \
--header 'Authorization: Bearer Atza|IQEBLjAsAhRmHjNgHpi0UDme37rR6CuUpSR' \
--header 'Amazon-Advertising-API-ClientID: amzn1.application-oa2-client.8baa9caa3eac48eab89780e73ce03b19' \
--header 'Content-Type: application/json' \
--data '{
    "operation": "DELETE",
    "users": [
        {
            "advertiserId": 205759403805,
            "consentTime": 1581557890000,
            "userId": {
                "type": "COOKIE",
                "value": "EMpBAI0GRcK4nBNGpPGg5g"
            }
        },
        {
            "advertiserId": 305759403805,
            "consentTime": 1581557900000,
            "userId": {
                "type": "COOKIE",
                "value": "EMpBAI0GRcK4nBNGpPGg5g"
            }
        }
    ]
}'

返回响应

🟢202成功

application/json

已提交删除用户数据的请求。

Bodyapplication/json

示例

{
    "requestId": "F88750355N-B70JY53CSD"
}

🟠400请求有误

🟠413

🟠429

🔴500服务器错误

🔴503服务器故障

修改于 2026-08-27 23:21:02

Updates metadata of an existing audience specified by identifier. Note that the API call rate is limited to 1 transaction per second (TPS). Calls exceeding this rate are throttled.

Gets advertising eligibility status for a list of products.