我们的客户端库会自动处理下述细节 只有在您对 或者未使用我们的任何客户端库。
本部分面向已熟悉 符合 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
值)后,
令牌失效。您可以使用刷新令牌进行刷新
访问令牌已过期。默认情况下,我们的客户端库会自动刷新过期的访问令牌。