测试

无论您是刚开始集成 Google Ads API、维护应用,还是向现有集成添加新功能,测试都是构建成功集成的重要步骤。本指南介绍了一些测试 Google Ads API 集成的最佳实践。

测试账号和生产账号

测试账号可用于开发目的。借助测试账号,您可以验证应用代码和配置是否按预期运行。

不过,并非所有功能都可以在测试账号中进行测试。

如果测试账号限制导致您无法测试集成中的某些功能,您可以改用生产账号进行开发。您的 Google Cloud 项目必须至少具有探索者访问权限级别(探索者、基本或标准),才能调用生产账号。请注意,探索者权限仍会限制某些服务,包括结算(BillingSetupService和 AccountBudgetProposalService)、规划、账号创建和用户邀请(请参阅探索者功能限制),这些服务需要基本或标准权限。从具有测试访问权限级别的项目调用生产账号时,在 v25 及之后会返回 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,在 v24 及之前会返回 AuthorizationError.ACTION_NOT_PERMITTED。

用于开发的生产账号与测试账号有以下不同:

  • 投放用户可以看到的广告
  • 需要提供有效的网址
  • 必须遵守广告政策

由于生产账号会投放广告,因此它们会生成指标,让您可以测试效果报告,并解锁 Google Ads API 的所有其他功能。 不过,在开发过程中使用这些模型时需要格外谨慎。我们建议您采取以下措施:

  • 仅向出于开发目的而需要访问权限的用户授予访问权限。
  • 设置一个固定的、较低的每日账号预算。
  • 仅当无法使用测试账号时,才使用生产账号进行开发。

因此,如需对集成进行全面测试,您可能需要同时使用测试凭据和生产凭据。

测试凭据

为了最大限度地降低在尝试修改开发者账号时意外修改生产账号的风险,我们建议您维护一组与生产应用凭证分开的测试凭证。

如需创建一组测试凭证,请按以下步骤操作:

  1. 创建一个仅用于测试目的的电子邮件账号(例如 api.test@example.com)或服务账号。
  2. 在您要测试的 Google Ads 账号中,将此用户或服务账号添加为有效用户。请确保为此用户或服务账号授予适当的访问权限级别。请勿向此用户或服务账号授予对任何生产账号的访问权限。
  3. 如果您使用的是 OAuth 2.0 用户身份验证流程,而不是服务账号流程,请为测试用户账号生成刷新令牌。
  4. 在测试应用时,请使用这些新凭证。客户端 ID 和客户端密钥可重复用于测试目的,因为它们对确定可以访问哪些 Google Ads 账号没有影响。安全地存储所有凭据和刷新令牌,切勿将其提交到源代码控制系统。

提交验证请求

如果您只需要测试请求是否有效(例如,验证请求结构是否正确且不违反政策),可以使用 validate_only 字段,该字段适用于 GoogleAdsService.Search 请求(请注意,GoogleAdsService.SearchStream 不支持 validate_only)和大多数 mutate 请求。请参阅参考文档,验证此字段是否适用于给定方法。

REST API

对于临时测试(例如验证请求是否产生预期输出),使用 REST API 通常是最简单的选择。请参阅 REST 示例,了解如何使用 curl 向 REST API 发出请求。此外,请尝试在 REST Explorer 中进行测试。