Google Ads API is returning to beta status. Please read our blog post for more details.

适用于 Google Ads API 的 OAuth2 内部

就以下所涉及的详细信息而言,我们的客户端库会实现自动处理,因此只有在您对后台发生的情况感兴趣时,或者您没有使用我们的任何客户端库时,才需要继续阅读。

本部分的目标读者是熟悉 OAuth 2.0 规范并且了解如何结合使用 OAuth2 和 Google API 的高级用户。

范围

同一个访问令牌可授予对多个 API 的不同级别的访问权限。有一个称为 scope 的可变参数用于控制访问令牌允许的资源和操作集。在请求访问令牌期间,您的应用在 scope 参数中发送一个或多个值。

Google Ads API 的当前范围是:https://www.googleapis.com/auth/adwords

离线访问

Google Ads API 客户端应用通常会请求进行离线访问。例如,当您的用户并未实际在线浏览您的网站时,您的应用可能会希望运行批处理作业。

要为某网络应用类型请求离线访问,请确保将 access_type 参数设置为 offline。您可以在 Google 的 OAuth2 指南中找到更多信息。

对于已安装应用类型,离线访问在默认情况下处于启用状态,因此您不必专门请求离线访问。

请求标头

gRPC 标头

当使用 gRPC API 时,您应在每个请求中添加访问令牌。您可以将 Credential 绑定到某个 Channel,使之用于该 Channel 上的所有请求。您还可以针对每次调用发送自定义凭据。有关处理授权的详细信息,请查阅gRPC 授权指南

REST 标头

在使用 REST API 时,您应该通过 HTTP 标头 Authorization 传递访问令牌。HTTP 请求示例如下所示:

GET /v1/customers/123456789 HTTP/2
Host: googleads.googleapis.com
User-Agent: INSERT_USER_AGENT
Accept: */*
Authorization: Bearer INSERT_ACCESS_TOKEN
developer-token: INSERT_DEVELOPER_TOKEN

您应为自己的应用自定义粗体内容。

访问令牌和刷新令牌

在大多数情况下,您需要安全地存储刷新令牌以备将来使用。要详细了解如何请求访问令牌和刷新令牌,请参阅与您的应用类型对应的指南:

访问令牌过期

访问令牌有一个基于 expires_in 值的过期时间;过期后,令牌即会失效。您可以使用刷新令牌刷新过期的访问令牌。默认情况下,我们的客户端库会自动刷新过期的访问令牌。