保护您的凭据

本指南介绍了如何确保您的应用和用户凭据是安全的。

完成 OAuth 应用验证

Google Ads API 的 OAuth 2.0 范围被归类为受限范围,这意味着您应该先完成 OAuth 应用验证流程,然后再将应用投入生产。如需了解详情,请参阅 Google 身份文档帮助中心文章

保护应用凭据

您应妥善保护应用的 OAuth 2.0 客户端 ID 和客户端密钥。这些凭据可以帮助您的用户和 Google 识别您的应用,因此应谨慎处理。您应该将这些应用凭据视为密码。请勿使用不安全的机制(例如在公共论坛上发帖、在电子邮件附件中发送包含这些凭据的配置文件、对凭据进行硬编码或将凭据提交到代码库)来共享凭据。建议尽可能使用 Secret 管理器,例如 Google Cloud Secret ManagerAWS Secret Manager

如果您的 OAuth 2.0 客户端密钥被盗,您可以重置这些密钥。开发者令牌也可以重置

保护开发者令牌

利用开发者令牌,您可以对帐号进行 API 调用,但对于可使用哪些帐号进行调用,这些令牌没有任何限制。因此,其他人可以使用已破解的开发者令牌进行归因于您的应用的调用。为避免这种情况,请采取以下预防措施:

  • 像对待密码一样来对待开发者令牌。请勿采用不安全的机制进行分享,例如在公共论坛上发帖或以电子邮件附件形式发送包含开发者令牌的配置文件。建议尽可能使用 Secret Manager,例如 Google Cloud Secret ManagerAWS Secret Manager

  • 如果您的开发者令牌被盗,您应重置令牌。

    • 登录您在申请 Google Ads API 时使用的 Google Ads 经理帐号。
    • 前往工具和设置 > API 中心
    • 点击开发者令牌旁边的下拉箭头。
    • 点击重置令牌链接。您的旧开发者令牌应立即停止工作。
    • 更新应用的生产配置以使用新的开发者令牌。

保护服务帐号的安全

服务帐号需要全网域模拟才能与 Google Ads API 正常运行。此外,您应该是 Google Workspace 客户才能设置全网域模拟。出于这些原因,我们建议您在调用 Google Ads API 时不要使用服务帐号。但是,如果您决定使用服务帐号,则应按照以下方式保护服务帐号:

保护用户令牌

如果您的应用向多个用户授权,您应该采取额外的步骤来保护用户的刷新令牌和访问令牌。以安全的方式存储令牌,绝不要以明文形式传输。请使用适合您平台的安全存储系统。

处理刷新令牌的撤消和到期

如果您的应用在授权过程中请求 OAuth 2.0 刷新令牌,您还必须处理其失效或过期问题。刷新令牌可能会因各种原因而失效,您的应用应通过在用户下次登录会话期间重新授权或酌情清理其数据来做出适当的响应。离线作业(如 Cron 作业)应检测并记录刷新令牌已过期的帐号,而不是继续发出失败的请求。Google 可能会对持续产生大量错误的应用加以限制,以保持 API 服务器的稳定性。

管理多个范围的用户意见征求

如果您的应用请求对多个 OAuth 2.0 范围进行授权,用户可能不会授予您请求的所有 OAuth 范围。您的应用应通过停用相关功能来处理拒绝作用域请求。只有在用户明确表示有意使用需要该范围的特定功能后,您才能再次提示用户。在这种情况下,请使用增量授权来请求适当的 OAuth 范围。

如果应用的基本功能需要多个范围,请在提示用户同意之前向用户说明此要求。