借助 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。
如果调用成功,则会返回一个 Account 资源,其中包含新测试账号的唯一 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 搜索或购物广告)。
- 受限端点:使用某些功能时,您无法使用测试账号,例如:
- 关联限制:您无法将测试账号与其他 Google Ads 账号或 Google 商家资料账号相关联。
- 测试账号无需注册:您无法为测试账号执行注册。
最佳做法
我们建议您在使用测试账号时遵循一些最佳实践:
- 沙盒优先开发:在将新的集成功能应用于生产环境之前,请务必先在测试账号中验证这些功能。
- 自动化集成测试:使用测试账号作为稳定环境来运行自动化回归测试。
- 测试账号命名:使用
account_name来提示每个测试账号的用途,例如“迁移测试”或“集成测试账号”。