History of entity changes.

POST

/history

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

责任人：未设置

返回提供的事件源的变更历史记录，这些事件源与指定的过滤器和时间范围匹配。只能查询属于经过身份验证的广告主的事件。所有时间都将采用 UTC Epoch 格式。此 API 接受字母数字格式（默认）或数字格式的标识符。如果提供数字 ID，将返回数字 ID，否则返回字母数字 ID。此 API 仅返回商品推广和品牌推广广告活动的变更历史记录。不返回展示型推广广告活动的更改。此外，它不返回有关谁进行了更改的信息。

API 版本控制： 此 API 通过 Accept 标头支持版本控制。使用 Accept: application/vnd.historyresponse.v1.1+json 来访问版本 1.1 功能。THEME 事件类型需要版本 1.1 或更高版本。 如果没有正确的 Accept 标头，THEME 请求将返回 400 错误。

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

请求参数

Body 参数application/json必填

示例

{
    "count": "200",
    "eventTypes": {
        "THEME": {
            "filters": [
                "STATUS"
            ],
            "parents": [
                {
                    "adGroupId": "501439770526954",
                    "campaignId": "350988133398470",
                    "useProfileIdAdvertiser": "false"
                }
            ]
        }
    },
    "fromDate": "1704195640000",
    "sort": {
        "direction": "DESC",
        "key": "DATE"
    },
    "toDate": "1704295640000"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/history' \
--header 'Content-Type: application/json' \
--data '{
    "count": "200",
    "eventTypes": {
        "THEME": {
            "filters": [
                "STATUS"
            ],
            "parents": [
                {
                    "adGroupId": "501439770526954",
                    "campaignId": "350988133398470",
                    "useProfileIdAdvertiser": "false"
                }
            ]
        }
    },
    "fromDate": "1704195640000",
    "sort": {
        "direction": "DESC",
        "key": "DATE"
    },
    "toDate": "1704295640000"
}'

返回响应

🟢200成功

application/json

成功的查询。结果包含与查询匹配的历史事件

Bodyapplication/json

示例

{
    "events": [
        {
            "changeType": "BID_AMOUNT",
            "entityId": "string",
            "entityType": "AD",
            "metadata": {
                "adGroupId": "string",
                "campaignBudgetType": "DAILY",
                "campaignId": "string",
                "keyword": "string",
                "keywordType": "KEYWORD_BROAD",
                "negativeTargetingType": "NEGATIVE_KEYWORD_BROAD",
                "placementGroupPosition": "DETAIL_PAGE",
                "predefinedTarget": "CLOSE-MATCH",
                "productTargetingType": "EXPRESSION",
                "targetingExpression": "string",
                "targetingType": "string",
                "theme": "string"
            },
            "newValue": "string",
            "previousValue": "string",
            "timestamp": 0
        }
    ],
    "nextToken": "string",
    "totalResults": 0
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠429

🔴500服务器错误

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

UpdateStreamSubscription

Creates a report request