Associates or disassociates a record with an audience. Note that the API call rate is limited to 100 transactions per second (TPS). Calls exceeding this rate are throttled. Payload size is limited to a maximum of 6MB or 2000 records. Calls with a payload

PATCH

/v2/dp/audience

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

责任人：未设置

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "patches": [
        {
            "consent": {
                "amazonConsent": {
                    "amazonAdStorage": "GRANTED",
                    "amazonUserData": "GRANTED"
                },
                "consentType": "TCF",
                "gpp": "DBADMZg~CQB2TAAQB2TAAPoABABGA9EAAAAAAAAAAAAAAAAAAAAA.QAAA.IAAA~BQB2TAAQB2TAAPoABABGBZCAAAAAAAgAAAAAAAAAAA.YAAAAAAAAAA~BAAAAAAAAQA.QA",
                "tcf": "CQB4ySFQB4ySFBlAAAENCZCAAAAAAAAAAAAAAAAAAAAA.II7Nd_X__bX9n-_7_6ft0eY1f9_r37uQzDhfNs-8F3L_W_LwX32E7NF36tq4KmR4ku1bBIQNtHMnUDUmxaolVrzHsak2cpyNKJ_JkknsZe2dYGF9Pn9lD-YKZ7_5_9_f52T_9_9_-39z3_9f___dv_-__-vjf_599n_v9fV_78_Kf9______-____________8A"
            },
            "op": "add",
            "path": "/COOKIE-EMpBAI0GRcK4nBNGpPGg5g/audiences",
            "value": [
                72057594038053890
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://www.amazon.com/ap/oa/v2/dp/audience' \
--header 'Authorization: Bearer Atza|IQEBLjAsAhRmHjNgHpi0UDme37rR6CuUpSR' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Content-Type: application/json' \
--data '{
    "patches": [
        {
            "consent": {
                "amazonConsent": {
                    "amazonAdStorage": "GRANTED",
                    "amazonUserData": "GRANTED"
                },
                "consentType": "TCF",
                "gpp": "DBADMZg~CQB2TAAQB2TAAPoABABGA9EAAAAAAAAAAAAAAAAAAAAA.QAAA.IAAA~BQB2TAAQB2TAAPoABABGBZCAAAAAAAgAAAAAAAAAAA.YAAAAAAAAAA~BAAAAAAAAQA.QA",
                "tcf": "CQB4ySFQB4ySFBlAAAENCZCAAAAAAAAAAAAAAAAAAAAA.II7Nd_X__bX9n-_7_6ft0eY1f9_r37uQzDhfNs-8F3L_W_LwX32E7NF36tq4KmR4ku1bBIQNtHMnUDUmxaolVrzHsak2cpyNKJ_JkknsZe2dYGF9Pn9lD-YKZ7_5_9_f52T_9_9_-39z3_9f___dv_-__-vjf_599n_v9fV_78_Kf9______-____________8A"
            },
            "op": "add",
            "path": "/COOKIE-EMpBAI0GRcK4nBNGpPGg5g/audiences",
            "value": [
                72057594038053890
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

已提交添加或移除受众的请求。请注意，请求处理最长可能需要两小时。

Bodyapplication/json

示例

{
    "jobId": "f076ddd9-3f84-44e8-b5cf-742b08f2bc9f",
    "requestId": "F88750355N-B70JY53CSD"
}

🟠400请求有误

🟠413

🟠429

🔴500服务器错误

🔴503服务器故障

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

getInsightsForStoreAPI

Creates a new data provider audience. Note that the API call rate is limited to 1 transaction per second (TPS). Calls exceeding this rate are throttled.