开发人员指南概述

亚马逊广告 API 概览

创建测试账户

亚马逊广告 API 中的 /testAccounts 接口允许用户进行以下操作：

适用于测试账户 API 的技术规范。

授权标头（Authorization header）

对 /testAccounts 接口的请求需要以下标头：

有关亚马逊广告 API 授权标头的更多信息，请参阅所需的授权标头。

创建测试账户

可以通过 POST 请求在 /testAccounts 中创建新的测试账户。

JSON 请求体（request body）包含三个参数：

按账户类型划分的支持站点

账户类型 支持的站点
VENDOR US、CA、BR、MX、JP、AU、SG、UK、IT、ES、FR、DE、AE、SA、NL、TR、PL、SE、EG、BE
AUTHOR US、UK、IT、ES、FR、DE

提示：供应商代码

供应商代码是已注册的供应商的五个字符代码。使用供应商代码创建的测试账户可以使用关联供应商的商品 ASIN 和元数据进行测试广告活动的创建。

在亚马逊广告平台中查找您的供应商代码的相关步骤*（点击展开）*
  1. 使用已注册的供应商账户登录亚马逊广告平台。
  2. 点击“齿轮”图标以访问 **Administration（管理）**菜单。
  3. 选择 Access and settings（访问和设置）。
  4. 在左侧菜单中，选择 Selling account（销售账户）。
  5. 在右侧的 **Account Associations（账户关联）**下，展开 ** Vendor Central accoun（供应商平台账户）**下的账户。
  6. 显示的五个字符的代码表示供应商代码。选择一项以包含在您对 API 的请求中。

JSON 请求体示例

{
    "countryCode": "US",
    "accountMetaData": {
        "vendorCode": "ABCDE"
    },
    "accountType": "VENDOR"
}

使用 cURL 的示例请求

curl -X POST 'https://advertising-api.amazon.com/testAccounts' \
-H 'amazon-advertising-api-clientid: YOUR_LWA_CLIENT_ID' \
-H 'authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'content-type: application/json' \
-d '{"countryCode": "US","accountMetaData":{"vendorCode":"YOUR_VENDOR_CODE"},"accountType": "VENDOR"}'

注意

如果您没有访问已注册的供应商代码的权限，请省略 accountMetaData 密钥。

注意

每个站点的亚马逊用户账户只能创建一个作者广告测试账户。

响应

成功的响应返回 200 状态代码和以下格式的 JSON 响应体：

{ "requestId": "A7BCDGCEVXQ1CJJ4301V" }

requestId 可用于检索状态信息，如下一节所述。

如希望进一步了解错误响应，请参阅技术规范。

检查账户创建请求的状态

可以通过 GET 请求在 /testAccounts 中检索账户创建状态和已创建账户的详细信息。

从成功的 POST 请求中检索的 requestId 可作为查询参数传递，以检索有关该请求的详细信息。未包含 requestId 参数的请求将返回使用当前客户端 ID 和授权用户账户创建的所有测试账户的列表。

使用 cURL 的示例请求

curl -X GET \
https://advertising-api.amazon.com/testAccounts?requestId=A7BCDGCEVXQ1CJJ4301V \
-H 'amazon-advertising-api-clientid: YOUR_LWA_CLIENT_ID' \
-H 'authorization: Bearer YOUR_ACCESS_TOKEN'

注意

“A7BCDGCEVXQ1CJJ4301V” 是一个示例 requestId。使用从账户创建请求的响应中检索到的 requestId 来检查该请求的状态。

响应

对于使用 requestID 查询参数的请求，成功的响应会返回 200 状态代码和以下格式的 JSON 响应体：

[
    {
        "countryCode": "US",
        "asins": [],
        "accountType": "VENDOR",
        "id": "ENTITY012345678910",
        "status": "COMPLETED"
    }
]

提示：作者账户

上方的示例显示了创建供应商测试账户后的响应。对于作者账户，还会创建与该账户关联的 3 个测试电子书 ASIN。这些 ASIN 将在该请求的响应中的 asins 密钥下列出，并可在 48 小时后用于测试广告活动的创建。

有关响应模式和错误响应的完整信息，请参阅技术规范。

状态显示为 COMPLETED 表示您的广告测试账户已准备就绪。

要开始使用，请参阅使用测试账户。

Amazon Advertising logo