开发人员指南概述

亚马逊广告 API 概览

管理员账户

管理员账户能够使广告主及其代理商关联多个广告账户。在广告平台中，这意味着他们可以在单个控制面板中管理用户、处理账单以及查看账户级别的提醒、洞察信息和效果指标。

您可以在平台中创建管理员账户，或通过亚马逊广告 API 中的 POST /managerAccounts 接口来创建。任何亚马逊用户账户都可以创建管理员账户。一个亚马逊用户账户可以有多个管理员账户。

授权

要在亚马逊广告 API 中使用管理员账户，客户端应用程序可以提供访问令牌，代表有权访问管理员账户的亚马逊用户账户的授权。此访问令牌授权客户端应用程序代表管理员账户的关联账户向 API 发出请求。

权限

第三方拥有的关联搜索广告账户可以在平台中选择为管理员账户启用编辑者或查看者权限。对关联账户具有编辑者权限的管理员账户可以代表该账户在 API 中执行任何操作。

具有查看者权限的管理员账户可以访问数据和生成报告，但对于需要编辑者权限的请求会收到 401 Unauthorized 响应。

配置文件

特定关联账户的配置文件标识符可在向 API 发出的请求中用于访问该账户的数据和服务。每个关联的搜索广告账户的配置文件标识符都包含在GET /managerAccounts 接口的响应中。

此外，GET /profiles 接口会返回所有已向授权用户拥有的管理员账户授予编辑者权限的搜索广告账户，以及该用户账户直接拥有的任何配置文件。

管理员账户是否是全球范围的？

管理员账户可以接受任何站点或站点组合的关联账户。

在 API 中，在调用关联账户所在区域中的 API 主机时，管理员账户只能访问给定的关联账户。管理员账户发出的 GET /profiles 和 GET /managerAccounts 请求将仅返回调用的 API 主机所涵盖区域内的站点所属的配置文件。

管理的 DSP 账户

管理服务 DSP 广告主需要使用管理员账户来调用报告 API。此流程允许实体管理员向该实体内一个或多个广告主的管理员账户授予只读权限。

关联的 DSP 账户由 GET /managerAccounts 接口返回，其 accountType 为 “DSP_ADVERTISING_ACCOUNT”。使用关联账户的 dspAdvertiserId 字段作为 DSP 报告请求的账户 ID。

我还能在哪里使用管理员账户？

管理员账户仅提供通过亚马逊广告 API 或平台访问亚马逊广告数据和服务的方式。要访问亚马逊用户账户的其他服务，例如销售商 API，请使用为这些服务记录的身份验证方法。

API 操作

创建管理员账户

要为授权用户账户创建新的管理员账户，请向 POST /managerAccounts 发出请求，并在请求体中提供 managerAccountName 和 managerAccountType（“Advertiser”或“Agency”）的值：

{
    "managerAccountName": "string",
    "managerAccountType": "Advertiser"
}

每个管理员账户在创建时都没有关联账户。

列出管理员账户

GET /managerAccounts 的响应会列出授权用户账户的所有管理员账户。每个管理员账户包含最多 50 个关联账户的列表。

以下是一个响应示例，表示某个用户拥有一个管理员账户和一个关联的搜索广告账户：

{
    "managerAccounts": [
        {
            "linkedAccounts": [
                {
                    "accountId": "ENTITYxxxxxxxxxxx",
                    "accountName": "AdsCustomer, Inc.",
                    "accountType": "SELLER",
                    "dspAdvertiserId": "",
                    "marketplaceId": "ATVPDKIKX0DER",
                    "profileId": "xxxxxxxxxxxxxxxx"
                }
            ],
            "managerAccountId": "amzn1.ads1.ma1.xxxxxxxxxxxxxxxxxxxxxx",
            "managerAccountName": "my_manager_account"
        }
    ]
}

提示：对管理员账户进行管理

API 为每个管理员账户返回最多 50 个关联账户。要通过 API 管理 50 个以上的关联账户，您可以为同一个用户账户创建其他管理员账户。

关联或取消关联账户

通过广告平台可以轻松地将管理员账户与关联账户关联起来。有关将账户关联到管理员账户的说明，请访问平台支持中心的“向管理员账户添加账户”。

API 还有两个用于管理账户关联的接口：

要使用 POST /managerAccounts/{managerAccountId}/associate 接口，与访问令牌关联的用户账户必须对广告主账户和管理员账户都具有管理员访问权限。

提示

可通过此接口关联的账户与管理员账户的“您的账户”视图对应，此视图位于平台中的关联账户下。

对于 POST /managerAccounts/{managerAccountId}/disassociate 接口，只需要具有对管理员账户的权限。

Amazon Advertising logo