Creates a file-based export of Ads.

POST

/ads/export

最后修改时间：2026-08-27 23:50:25

责任人：未设置

为账户中满足筛选条件的广告创建基于文件的导出。

要了解异步导出的调用流程,请参阅Sponsored Ads 导出快速入门。

需要以下权限之一:
["advertiser_campaign_view"]

请求参数

Header 参数

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

示例

{
    "adProductFilter": [
        "SPONSORED_BRANDS",
        "SPONSORED_DISPLAY",
        "SPONSORED_PRODUCTS"
    ],
    "stateFilter": [
        "ENABLED",
        "PAUSED"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/ads/export' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Amazon-Advertising-API-Scope;' \
--header 'Content-Type: application/vnd.adsexport.v1+json' \
--data '{
    "adProductFilter": [
        "SPONSORED_BRANDS",
        "SPONSORED_DISPLAY",
        "SPONSORED_PRODUCTS"
    ],
    "stateFilter": [
        "ENABLED",
        "PAUSED"
    ]
}'

返回响应

🟢202成功

application/vnd.adsexport.v1+json

成功。

Bodyapplication/vnd.adsexport.v1+json

示例

{}

🟠400请求有误

🟠401没有权限

🟠406

修改于 2026-08-27 23:50:25

Creates a file-based export of Ad Groups.

Creates a file-based export of Campaigns.