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

OAuth Playground

OAuth2 凭据的另一种生成方法是使用 OAuth2 Playground。与 Google API 控制台配合使用后,OAuth2 Playground 可让您手动创建 OAuth2 令牌。

OAuth2 Playground 适用于只需访问单个经理帐号下或 Google Ads 用户的帐号的用户。如果您需要提示多个用户提供各自的凭据,那么最好在 Google Ads API 中为 OAuth 配置客户端库

获取客户端 ID 和客户端密钥

如果您还没有 Google Cloud 项目,请执行以下操作:

  1. 打开 Google API 控制台“凭据”页面

  2. 从项目下拉菜单中选择现有项目或新建项目。

  3. 在“凭据”页面上,选择创建凭据,然后选择 OAuth 客户端 ID

  4. 应用类型下,选择网络应用

  5. 已获授权的重定向 URI 下,添加一行:https://developers.google.com/oauthplayground

  6. 点击创建

  7. 记下“客户端 ID”页面上的客户端 ID客户端密钥。您将在下一步中用到它们。

如果您已有 Google Cloud 项目,则可以按上面所述设置已获授权的重定向 URI,以此方式重复使用现有的项目。

生成令牌

  1. 转到 OAuth2 Playground(使用此链接后,系统应为您预先填充一些键值对)。

  2. 点击右上角的齿轮图标 ,然后选中标有 Use your own OAuth credentials 的框(如果尚未选中的话)。

  3. 请确保:

    • OAuth flow 设置为 Server-side
    • Access type 设置为 Offline(这可确保您获得刷新令牌和访问令牌,而不只是访问令牌)。
  4. 输入您在上面获取的 OAuth2 客户端 IDOAuth2 客户端密钥

    Playground 设置

  5. 在标记为 Step 1 - Select & authorize APIs 的部分中,在底部的文本框中输入以下网址(如果文本框中无此内容),然后点击 Authorize APIs

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

    授权 API

  6. 如果出现提示,请登录您希望为其授予访问权限和授权的帐号。否则,请确认目前右上角的 Google 用户就是您想为其获取凭据的 Google Ads 帐号或经理帐号。

  7. 系统会提示您,您的应用将要管理您的 Google Ads 广告系列。请点击 Accept 继续下一步。

  8. 在标记为 Step 2 - Exchange authorization code for tokens 的标签中,应该会显示 Authorization code。点击 Exchange authorization code for tokens

    Playground 授权代码令牌

  9. 如果一切顺利,系统应该已为您填写 Refresh tokenAccess token(您可能需要重新展开 Step 2 - Exchange authorization code for tokens 查看这些值):

    Playground 刷新令牌

  10. 刷新令牌客户端 ID客户端密钥一起复制到您选择的客户端库的配置文件中。

  11. 在 Google Ads API 中为 OAuth 配置客户端库

从您的客户端 ID 中移除 OAuth2 Playground

既然您已拥有刷新令牌,就不再需要将 OAuth2 Playground 用作已获授权的重定向 URI 了;要将其从已获授权的重定向 URI 列表中移除,请按以下步骤操作:

  1. 转到 Google API 控制台“凭据”页面

  2. 从项目下拉列表中选择您的项目。

  3. 在“凭据”页面上,点击客户端 ID 名称进行修改。

  4. 已获授权的重定向 URI 中移除 https://developers.google.com/oauthplayground。请注意,您必须至少留下一个重定向 URI。

  5. 点击保存