适用于 Google Ads API 的 OAuth2 内部

我们的客户端库会自动处理下述细节只有在您对或者未使用我们的任何客户端库。

本部分面向已熟悉符合 OAuth 2.0 规范并了解如何结合使用 OAuth2 和 Google API。

想要详细了解 API 中的身份验证？

视频库：身份验证和授权

范围

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

Google Ads API 的范围如下：

https://www.googleapis.com/auth/adwords

离线访问

Google Ads API 客户端应用通常会请求进行离线访问。例如：您的应用可能需要在用户未实际在线时运行批量作业浏览你的网站

若要针对某类 Web 应用请求离线访问，请务必将将 access_type 参数设置为 offline。如需更多信息，请参阅 Google 的 OAuth2 指南。

对于桌面应用类型，离线访问在默认情况下处于启用状态，您需要则不必明确请求

请求标头

gRPC 标头

使用 gRPC API 时，请在每个请求中添加访问令牌。您可以将将 Credential 添加到 Channel，以便用于该频道上的所有请求。您可以还可以为每个调用发送自定义凭据。gRPC 授权指南包含更多了解有关处理授权的详细信息。

REST 标头

使用 REST API 时，通过 HTTP 标头传递访问令牌 Authorization。HTTP 请求示例如下所示：

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

访问令牌和刷新令牌

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

刷新令牌过期

有关刷新令牌到期时间的更多详细信息，请参阅 Google Identity Platform OAuth 文档。

访问令牌过期

访问令牌有一个过期时间（根据 expires_in 值）后，令牌失效。您可以使用刷新令牌进行刷新访问令牌已过期。默认情况下，我们的客户端库会自动刷新过期的访问令牌。