DspAudienceEdit

PUT

/dsp/audiences/edit

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

责任人：未设置

根据受众定义和受众 ID 更新现有的定向受众。

需要以下权限之一：
["advertiser_campaign_edit","audiences_edit"]

请求参数

Header 参数

Body 参数application/vnd.dspaudiences.v1+json必填

示例

{
    "dspAudienceEditRequestItems": [
        {
            "audienceId": "4ga88r63",
            "audienceType": "PRODUCT_PURCHASES",
            "description": "Audience Name 的描述。",
            "idempotencyKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "lookback": "10",
            "name": "AudienceName",
            "rules": [
                {
                    "attributeType": "ASIN",
                    "attributeValues": [
                        "B08V4T57R2"
                    ],
                    "clause": "INCLUDE",
                    "operator": "ONE_OF"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://www.amazon.com/ap/oa/dsp/audiences/edit' \
--header 'AdvertiserId: myAdvertiserId' \
--header 'Amazon-Advertising-API-ClientId: myClientId' \
--header 'Amazon-Advertising-API-Scope: myAPIScope' \
--header 'Content-Type: application/vnd.dspaudiences.v1+json' \
--data '{
    "dspAudienceEditRequestItems": [
        {
            "audienceId": "4ga88r63",
            "audienceType": "PRODUCT_PURCHASES",
            "description": "Audience Name 的描述。",
            "idempotencyKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "lookback": "10",
            "name": "AudienceName",
            "rules": [
                {
                    "attributeType": "ASIN",
                    "attributeValues": [
                        "B08V4T57R2"
                    ],
                    "clause": "INCLUDE",
                    "operator": "ONE_OF"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/vnd.dspaudiences.v1+json

DspAudienceEdit 200 响应

Bodyapplication/vnd.dspaudiences.v1+json

示例

{}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429

🔴500服务器错误

🔴502网关错误

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

DspAudienceDelete

Upload a batch of hashed records for matching