返回

如何获取和管理 Google Ads API 令牌?获取访问令和刷新令牌指南

php

获取 Google Ads API 的访问令和刷新令牌

介绍

Google Ads API 是一组强大的工具,可让您自动执行 Google Ads 帐户的管理。要使用这些 API,您需要访问令牌和刷新令牌。本文将逐步指导您如何请求和解析这些令牌,以便充分利用 Google Ads API 的功能。

获取访问令牌

获取访问令牌的第一步是向 Google 发送一个 POST 请求,其中包含以下信息:

  • state 参数:任意唯一字符串,可用于防止跨站点请求伪造 (CSRF) 攻击。
  • code 参数:您从 Google 重定向到回调 URL 时收到的代码。

请求的 URL 为:

https://oauth2.googleapis.com/token

请求的正文应以 application/x-www-form-urlencoded 格式编码,如下所示:

grant_type=authorization_code
code=<code from callback URL>
client_id=<client ID from GenerateUserCredentials.php>
client_secret=<client secret from GenerateUserCredentials.php>
redirect_uri=<redirect URI from GenerateUserCredentials.php>

服务器将返回一个 JSON 响应,其中包含访问令牌、刷新令牌和过期时间等信息。

解析访问令牌响应

访问令牌响应包含以下字段:

  • access_token:用于对 Google Ads API 发出请求的令牌。
  • refresh_token:用于在访问令牌过期后获取新访问令牌的令牌。
  • expires_in:访问令牌的到期时间(以秒为单位)。

刷新访问令牌

访问令牌具有有限的有效期。要继续使用 Google Ads API,您需要使用刷新令牌获取新访问令牌。

向 Google 发送一个 POST 请求,其中包含以下信息:

  • refresh_token 参数:访问令牌响应中提供的刷新令牌。

请求的 URL 为:

https://oauth2.googleapis.com/token

请求的正文应以 application/x-www-form-urlencoded 格式编码,如下所示:

grant_type=refresh_token
refresh_token=<refresh token from access token response>
client_id=<client ID from GenerateUserCredentials.php>
client_secret=<client secret from GenerateUserCredentials.php>

服务器将返回一个 JSON 响应,其中包含新的访问令牌、刷新令牌和过期时间。

存储和管理令牌

将访问令牌和刷新令牌存储在安全的地方非常重要。访问令牌在大约 1 小时后过期,因此您需要使用刷新令牌定期获取新访问令牌。

常见问题解答

  1. 我的访问令牌为什么无效?
    • 访问令牌的有效期为 1 小时。请使用刷新令牌获取新访问令牌。
  2. 我的刷新令牌为什么无效?
    • 如果您的 Google 帐户安全设置发生了更改,您的刷新令牌可能会无效。您需要生成一个新令牌。
  3. 如何吊销我的访问令牌或刷新令牌?
  4. 我可以有多个刷新令牌吗?
    • 每个 Google 帐户只能有一个有效的刷新令牌。
  5. 我可以使用 Google Ads API 做什么?
    • Google Ads API 允许您管理您的 Google Ads 帐户,包括创建和编辑广告系列、广告组和广告。

结论

获取和管理 Google Ads API 的访问令和刷新令牌对于充分利用该 API 的功能至关重要。遵循本文中概述的步骤,您可以轻松获取和更新令牌,从而自动化您的 Google Ads 管理任务并提高效率。