开发人员指南概述

亚马逊广告 API 概览

开发人员说明

对象编号

API 为所有实体分配不可变的编号。这些实体编号用于对通过报告接口检索的效果数据与通过广告活动管理界面管理的广告活动实体进行一致性处理。每个实体的编号都在 64 位无符号整数的范围内。编号对于给定类型是唯一的，但是两个不同类型的对象可能共享相同的编号（例如，广告活动的 campaignId 可能与无关的广告组的 adGroupId 相同）。

每种类型的编号在配置文件中是唯一的。例如，与同一配置文件关联的两个广告活动（不管广告类型如何）不能共享一个 campaignId，但您可能会在不同的配置文件下看到相同的 campaignId。

存档

这是一项更改。不允许修改已存档的实体，但您仍可以像以前一样在广告活动管理器和可下载报告中查看已存档的实体及其效果。此外，我们不会将已存档的实体计入我们实施的实体限制中，这实际上会增加您的实体限制。

分页一致性

当通过管理 API 进行批量请求时，每个分页请求是独立进行的。结果的排序是一致的，但是如果满足筛选条件的记录集合在分页请求之间发生更改，则分页可能导致重复或丢失记录。实体快照和报告不会遇到同样的问题。

操作的原子性

请注意，批量更新和创建操作是非原子的。

幂等性

所有操作都是幂等的，即如果多次执行相同的操作，最终服务器状态将保持不变。但是，这并不保证会返回相同的响应，因为重复创建将在第二个请求中发生错误。

对于创建操作，幂等性由以下唯一性约束保证，当违反这些约束时，将返回指示资源已存在的错误：

对于报告和快照，文件会被缓存，因此重复请求将返回相同的报告编号

部分更新

更新实体所需的唯一属性是编号。这允许进行部分更新，即仅提供子集属性并且所有其他属性将保持不变。这允许对于常见操作（例如更改大批量关键词竞价）更简洁的请求。

隐式操作

批量更新可以用于隐式地创建和归档/删除实体。在更新中如果没有编号，并且包含了创建所需的所有属性，则表示要创建一个新实体。类似地，如果存在编号并且状态为已存档，则可以用于归档实体。

异步快照与同步批量获取对于广告活动管理

API 用于同步批量操作来获取广告活动、广告组、关键词和广告。此外，API 还提供了获取单个类型所有实体的完整快照的异步接口。如果客户端计划批量获取所有广告活动、广告组、关键词或广告，快照通常更高效。这对于本地复制账户结构的客户很有用。

要了解每种广告类型的快照规范，请参见：

获取扩展属性

由于扩展属性包括计算/继承状态，请求批量获取这些属性的成本更高。建议客户端尝试使用存储的父级和祖父级状态在本地计算继承状态，特别是如果多次请求账户结构的情况。

品牌推广广告审核

亚马逊广告认为，针对亚马逊所提供的广告服务维持较高的顾客体验标准，有助于为亚马逊的广告主带来更满意的效果。因此，我们制定了以客户为中心的广告政策来帮助保护和提升该体验。当用户提交新的品牌推广活动或更改现有广告活动时，我们会使用审核流程对其进行审核，以确保它符合我们为整个亚马逊买家购物体验设定的高标准。正在接受审核的广告活动将被设置为“待审核”状态。与广告主的账户关联的电子邮件地址中将收到一封电子邮件，确认广告活动正处于审核中。广告主将在 72 小时内收到一封电子邮件，确认其广告是否获得批准。请注意，目前未对沙箱提供审核功能。

Amazon Advertising logo