亚马逊广告 API 概览

亚马逊广告 API 让亚马逊广告主和亚马逊广告合作伙伴网络 成员能够以程序化方式管理广告操作。

您可以通过选择左侧的菜单树中的选项，找到 API 的参考文档，以及功能说明、发布说明、建议和教程。

刚接触亚马逊广告 API？

在左侧的目录或下方的列表中找到实用的首次使用步骤：

• 入门：有关获取访问权限的分步骤说明。
• 入门：有关管理身份验证并进行首次请求的分步骤说明。

REST 设计

该 API 提供了一个 RESTful 的服务接口，用于对广告活动实体执行读取和写入操作。它还支持灵活的报告功能，用于请求更精细的效果数据。使用经过身份验证的 HTTP POST、GET、PUT 和 DELETE 方法分别创建、读取、更新及删除实体和报告。所有实体的创建或更新操作都使用请求体（request body）中的 JSON 输入。

该 API 针对大批量操作进行了优化，可能需要几秒钟才能返回结果。它还将对广告活动结构数据的访问权限与绩效指标分开。效果指标只能通过异步报告（asynchronous report）来获取。

建议在通过 API 检索的数据中保留本地副本，以驱动应用程序的用户界面和优化算法。

典型适用场景

我们预计典型的客户端将定期执行以下操作：

1. 批量请求所有广告活动、广告组、广告和关键词，并存储/更新数据的本地副本。
2. 请求所有广告活动、广告组、广告和关键词的最新绩效数据，并使用编号（ID）将绩效数据与从批量请求中检索到的实体进行关联并存储/更新。
3. 分析效果并更改竞价和预算。使用广告活动、广告组、广告和关键词的批量更新 API 优化效果。

这些操作以及修改单个实体的操作是 API 支持的适用场景。

API 接口

您可通过以下 URL 接口访问 API：

URL	地区	站点
https://advertising-api.amazon.com	北美 (NA)	美国 (US)、加拿大 (CA)、墨西哥 (MX)、巴西 (BR)
https://advertising-api-eu.amazon.com	欧洲 (EU)	英国 (UK)、法国 (FR)、意大利 (IT)、西班牙 (ES)、德国 (DE)、荷兰 (NL)、阿联酋 (AE)、波兰 (PL)、土耳其 (TR)、埃及 (EG)、沙特阿拉伯 (SA)、瑞典 (SE)、比利时 (BE)、印度 (IN)
https://advertising-api-fe.amazon.com	远东 (FE)	日本 (JP)、澳大利亚 (AU)、新加坡 (SG)