开发人员指南概述

亚马逊广告 API 概览

权限

给定广告账户的用户账户权限级别决定了该用户查看或编辑该广告账户的能力。

在广告平台中,为登录的用户账户设置的权限会影响用户界面的行为。

在亚马逊广告 API 中,为登录的用户账户设置的用于创建授权 的权限决定了给定的请求是否会获得授权。

权限和配置文件

要完成对 API 的大多数请求,必须提供广告账户的配置文件标识符。默认情况下,GET /profiles 接口仅显示具有查看和编辑权限的配置文件。可以使用请求中的 apiProgramaccessLevel 查询参数来调整响应。

例如,下面的请求将返回北美地区的配置文件列表,其中授权账户对报告具有查看权限:

https://advertising-api.amazon.com/v2/profiles?accessLevel=view&apiProgram=report

如需进一步了解,请查看配置文件的技术规范

提示:管理员账户

对于由管理员账户确定的权限,同样的筛选行为也适用于配置文件。管理员账户用户还可以使用 GET /managerAccounts 接口查看所有关联账户的配置文件标识符。

响应状态

如果授权的用户账户有权对在 Amazon-Advertising-API-Scope 标头(header)中提供的配置文件标识符对应的账户执行所请求的操作,则对 API 的请求将获得授权。

如果授权账户没有所需的权限,则请求将收到 401 Unauthorized 响应。

设置权限

默认情况下,搜索广告账户的创建者拥有管理员权限。在广告平台中,拥有管理员权限的用户可以通过设置权限来允许其他用户账户访问广告账户。

管理员用户可以选择两种方法来启用其他用户账户的访问权限:管理员账户和访问权限控制。

管理员账户

广告主可以允许访问管理员账户,可以为其分配查看者编辑者权限。进一步了解管理员账户

访问权限控制

广告主可以使用访问权限控制邀请其他用户账户访问广告账户,并确定该用户账户的权限级别。

对于供应商账户

对于供应商账户,可以根据三个默认层级在广告平台中共享权限:

或者,管理员用户可以选择通过六个权限字段向给定用户授予精细权限。其中四个字段会影响 API 中的行为。下面列出了这些字段,以及每种类型的查看查看和编辑权限的名称,如支持中心的“权限定义”所述。

平台中的名称 “查看”权限名称 “查看和编辑”权限名称 实现方式
广告活动管理器 advertiser_campaign_view advertiser_campaign_edit 广告活动管理接口
广告报告 nemo_report_view nemo_report_edit 报告接口
品牌旗舰店生成器 不适用 amazon_stores_edit 品牌旗舰店接口
账单历史记录 nemo_transactions_view nemo_transactions_edit 账单接口

注意

付款设置和用户管理的权限不影响 API 的行为。

对于卖家账户

对于卖家账户,管理员用户可以在邀请其他用户后在卖家平台中管理精细权限。卖家账户的查看查看和编辑管理员权限在卖家账户影响 API 行为的方面与上述供应商账户的行为方式相同,包括: