Create brand group overrides

POST

/mmm/v1/brandGroupOverrides

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

责任人：未设置

为品牌组创建覆盖。覆盖强制品牌组在报告中包含或排除特定产品或广告活动。品牌组中的产品可以在 GET /mmm/v1/brandGroups/{brandGroupId}/products 中列出。品牌组中的广告活动可以在 GET /mmm/v1/brandGroups/{brandGroupId}/campaigns 中列出。某些覆盖需要亚马逊审查才能应用。如果品牌组具有 PENDING_REVIEW 的覆盖，在审查完成之前，该品牌组的新报告将不会处理。不被允许用于品牌组的覆盖将立即返回 403 错误代码。如果这是意外情况，请联系 mmm-support@amazon.com。

授权资源类型：
全球经理账户 ID

参数名称：
Amazon-Advertising-API-Manager-Account

参数位置：
标头

需要以下权限之一：
["MasterAccount_Manager","MasterAccount_Viewer","ManagerAccount_Dev","MA_ReadOnly"]

请求参数

Body 参数application/json

示例

{
    "overrides": [
        {
            "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
            "identifierType": "ASIN",
            "identifierValue": "B0018OFKJS",
            "overrideType": "INCLUDE"
        },
        {
            "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
            "identifierType": "CAMPAIGN_ID",
            "identifierValue": "2456167530601",
            "overrideType": "INCLUDE"
        },
        {
            "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
            "identifierType": "CAMPAIGN_ID",
            "identifierValue": "7286325070001",
            "overrideType": "EXCLUDE"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/mmm/v1/brandGroupOverrides' \
--header 'Content-Type: application/json' \
--data '{
    "overrides": [
        {
            "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
            "identifierType": "ASIN",
            "identifierValue": "B0018OFKJS",
            "overrideType": "INCLUDE"
        },
        {
            "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
            "identifierType": "CAMPAIGN_ID",
            "identifierValue": "2456167530601",
            "overrideType": "INCLUDE"
        },
        {
            "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
            "identifierType": "CAMPAIGN_ID",
            "identifierValue": "7286325070001",
            "overrideType": "EXCLUDE"
        }
    ]
}'

返回响应

🟢207

application/json

操作成功。

Bodyapplication/json

示例

{
    "overrides": {
        "error": [
            {
                "error": {
                    "code": "404",
                    "message": "Not found"
                },
                "index": "1"
            }
        ],
        "success": [
            {
                "index": "0",
                "override": {
                    "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
                    "identifierType": "ASIN",
                    "identifierValue": "B0018OFKJS",
                    "overrideId": "5f47524b-0c20-405e-95c7-abe8965f28b2",
                    "overrideType": "INCLUDE",
                    "status": "PENDING_REVIEW"
                }
            },
            {
                "index": "2",
                "override": {
                    "brandGroupId": "23d7c364-0124-410b-b899-8475eddbafef",
                    "identifierType": "CAMPAIGN_ID",
                    "identifierValue": "7286325070001",
                    "overrideId": "4d493a60-02af-4e49-a318-b8bf1e8cbbae",
                    "overrideType": "EXCLUDE",
                    "status": "APPROVED"
                }
            }
        ]
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠429

🔴500服务器错误

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

Associate/Dissociate conversion definitions to an order.

Delete brand group overrides