测试

无论是刚刚入门、维护应用,还是为现有集成添加新功能,测试都是构建成功的 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 的所有其他功能。 不过,将它们用于开发需要格外谨慎。我们建议您采取以下措施:

  • 仅向需要用于开发目的的用户授予访问权限。
  • 设置固定的低每日账号预算。
  • 仅在无法使用测试账号时,才将生产账号用于开发。

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

测试凭据

为了尽可能降低在尝试修改开发者账号时意外修改生产账号的风险,我们建议您维护一组与生产应用凭据分开的测试凭据。

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

  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 中进行测试。