无论您是刚刚开始、维护应用,还是向现有集成添加新功能,测试都是构建成功的 Google Ads API 集成的重要一步。本指南介绍了一些用于测试 Google Ads API 集成的最佳实践。
测试账号和正式账号
测试账号可用于开发目的。借助测试账号,您可以验证应用代码和配置是否按预期运行。
不过,并非所有功能都可以在测试账号中进行测试。
如果测试账号的限制导致您无法测试集成中的某些功能,您可以改用正式版账号进行开发。您的 Google Cloud 云项目必须至少具有 Explorer 访问权限级别(Explorer、Basic 或 Standard),才能调用产品账号。请注意,“探索者”访问权限仍会限制对某些服务(包括结算 [BillingSetupService 和 AccountBudgetProposalService]、规划、账号创建和用户邀请 [请参阅“探索者”功能限制])的访问,这些服务需要“基本”或“标准”访问权限。尝试从具有“测试”访问权限级别的项目调用生产账号时,从 v25 开始会返回 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,而在 v24 及更早的版本中会返回 AuthorizationError.ACTION_NOT_PERMITTED。
用于开发的生产账号与测试账号在以下方面有所不同:
- 投放用户可以看到的广告
- 需要提供有效的网址
- 必须遵守广告政策
由于生产账号会投放广告,因此会生成指标,让您能够测试效果报告,并解锁 Google Ads API 的所有其他功能。不过,在开发中使用它们需要格外谨慎。我们建议采取以下措施:
- 仅向出于开发目的需要访问权限的用户授予访问权限。
- 设置固定的低每日账号预算。
- 仅当无法使用测试账号时,才使用生产账号进行开发。
因此,要对集成进行全面测试,您可能需要测试凭据和正式版凭据。
测试凭据
为了尽量减少在尝试修改开发账号时意外修改生产账号的风险,我们建议您维护一组与生产应用凭据分开的测试凭据。
如需创建一组测试凭据,请按以下步骤操作:
- 创建一个仅用于测试的电子邮件账号(例如
api.test@example.com)或服务账号。 - 将此用户或服务账号添加为您要进行测试的 Google Ads 账号中的有效用户。请确保为此用户或服务账号授予适当的访问权限级别。请勿向此用户或服务账号授予对任何生产账号的访问权限。
- 如果您使用的是 OAuth 2.0 用户身份验证流程,而不是服务账号流程,请为测试用户账号生成刷新令牌。
- 在测试应用时,请使用这些新凭据。客户端 ID 和客户端密钥可重复用于测试目的,因为它们不会影响可访问的 Google Ads 账号。安全地存储所有凭据和刷新令牌,切勿将其提交到源代码控制系统。
提交验证请求
如果您只需要测试请求是否有效(例如,验证请求的结构是否正确且未违反政策),可以使用 validate_only 字段,该字段适用于 GoogleAdsService.Search 请求(请注意,GoogleAdsService.SearchStream 不支持 validate_only)和大多数 mutate 请求。请参阅参考文档,验证相应方法是否提供此字段。
REST API
对于临时测试(例如,验证请求是否会产生预期输出),使用 REST API 通常是最简单的选择。请参阅 REST 示例,了解如何使用 curl 向 REST API 发出请求。您也可以尝试在 REST 浏览器中进行测试。