无论是刚刚入门、维护应用,还是为现有集成添加新功能,测试都是构建成功的 Google Ads API 集成的重要一步。本指南介绍了一些测试 Google Ads API 集成的最佳实践。
测试账号和生产账号
测试账号可用于开发目的。借助测试账号,您可以验证应用代码和配置是否按预期运行。
不过,并非所有功能都可以在测试 账号中进行测试。
如果测试账号的限制导致您无法在集成中测试某些功能,您可以改用生产账号进行开发。您的
Google Cloud 项目必须至少具有
Explorer 访问权限级别(Explorer、Basic 或 Standard),才能
调用生产账号。请注意,Explorer 访问权限仍然会限制某些
服务,包括结算(BillingSetupService
和 AccountBudgetProposalService)、
规划、账号创建和用户邀请(请参阅 Explorer 功能
限制),这些服务需要 Basic 或 Standard
访问权限。尝试从具有测试访问权限级别的项目调用生产账号会返回
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
(从 v25 开始),而在
AuthorizationError.ACTION_NOT_PERMITTED(在 v24 及更早版本中)则会返回。
用于开发的生产账号与测试账号在以下方面有所不同:
- 投放用户可见的广告
- 需要有效的网址
- 必须遵守广告政策
由于生产账号会投放广告,因此会生成指标,让您可以测试效果报告,并解锁 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 Explorer 中进行测试。