Merchant API 中的测试账号

借助 Merchant API 测试账号功能,您可以在安全且隔离的空间中全面测试集成,然后再将其部署到正式环境中。通过使用沙盒测试账号,您可以在开发周期的早期阶段试验 API 调用、验证代码并找出潜在问题,而不会影响生产数据、中断实时运营或无意中违反 Merchant Center 政策。

前提条件

在创建和使用测试账号之前,请确保满足以下要求:

  • Merchant Center 账号: 您必须拥有 Merchant Center 账号。
  • Merchant API 访问权限: 您必须是 注册用户 的 Merchant API。

测试账号的优势

使用测试账号具有以下几项关键优势:

  • 设置简单: 测试账号设置流程简单,让您可以快速开始测试功能和集成。
  • 数据完整性和安全性: 生产数据受到保护,并且消除了生产账号中违反政策的风险。
  • 测试效率: 您可以测试各种不同的场景和极端情况,而无需为测试目的维护并行的生产账号。
  • 即时验证优惠: 利用测试账号自动免除首页声明和验证的优势,快速测试优惠插入。系统会默认批准测试账号的优惠。
  • 真实模拟: 该环境会模拟商品上传和产品目录管理系统等关键功能的生产行为,确保测试结果可靠。
  • 更顺畅的 API 迁移: 测试账号允许并排验证,方便用户从 Content API 迁移到 Merchant API 或从一个 API 版本迁移到另一个 API 版本,从而确保迁移过程顺利无忧。

如何创建测试账号

测试账号是使用 Merchant API 中的特定自定义方法创建的。

使用 accounts.createTestAccount 方法:

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

请替换以下内容

  • ACCOUNT_ID:您的 Merchant Center ID。
  • ACCESS_TOKEN:用于进行 API 调用的授权令牌
  • TEST_ACCOUNT_NAME:测试账号的名称。我们建议您使用有意义的名称,以表明这些账号用于测试。例如,在测试账号名称中包含 test 一词。

创建测试账号时,必须提供以下字段:

  • time_zone:账号的报告和显示时区。
  • language_code:账号的 BCP-47 语言代码,例如 en-US

调用成功后,系统会返回一个 账号 资源,其中包含新测试账号的唯一 accountId 和资源 名称:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

限制

测试账号专为功能验证而设计,并具有特定限制:

  • 测试账号数量: 每个 Google 账号最多可以创建 5 个测试账号。测试账号计入每个 Google 账号的 Merchant Center 账号默认限制。
  • 与 Merchant API 配额集成: 从 API 配额的角度来看,Merchant API 将测试账号视为生产账号。测试账号与生产账号受相同的配额限制。无法增加测试账号的配额。
  • 高级账号: 您无法创建高级测试账号,也无法将高级账号转换为测试账号。
  • 不公开投放: 提交到测试账号的数据永远不会在任何 Google 平台(例如搜索或购物广告)上发布。
  • 受限端点: 使用某些功能(例如:
  • 关联限制: 您无法将测试账号关联到其他 Google Ads 或 Google 商家资料账号。
  • 测试账号无需注册: 您无法为测试账号执行 注册

最佳实践

我们建议您在使用测试账号时遵循一些最佳实践:

  • 优先在沙盒中开发: 在将新集成功能应用于生产环境之前,务必先在测试账号中验证这些功能。
  • 自动化集成测试: 将测试账号用作运行自动化回归测试的稳定环境。
  • 测试账号命名: 使用 account_name 来提示每个测试账号的用途,例如“迁移测试”或“集成测试账号”。