借助 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来提示每个测试账号的用途,例如“迁移测试”或“集成测试账号”。