权限
给定广告账户的用户账户权限级别决定了该用户查看或编辑该广告账户的能力。
在广告平台中,为登录的用户账户设置的权限会影响用户界面的行为。
在亚马逊广告 API 中,为登录的用户账户设置的用于创建授权 的权限决定了给定的请求是否会获得授权。
权限和配置文件
要完成对 API 的大多数请求,必须提供广告账户的配置文件标识符。默认情况下,GET /profiles
接口仅显示具有查看和编辑权限的配置文件。可以使用请求中的 apiProgram
和 accessLevel
查询参数来调整响应。
例如,下面的请求将返回北美地区的配置文件列表,其中授权账户对报告具有查看权限:
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 行为的方面与上述供应商账户的行为方式相同,包括:
- 广告活动管理器
- 商品广告效果报告
- 商品广告发票历史记录
- 品牌旗舰店生成器