OAuth Playground

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

OAuth2 Playground 适用于只需访问单个经理账号下或 Google Ads 用户的账号的用户。如果您需要提示多个用户提供凭证，最好在 Search Ads 360 中为 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. 点击右上角的齿轮图标 ，然后勾选使用您自己的 OAuth 凭据复选框（如果尚未勾选）。

  3. 请确保：

    • OAuth flow 设置为 Server-side。
    • 访问权限类型设置为离线（这可确保您获得刷新令牌和访问令牌，而不仅仅是访问令牌）。

  4. 输入您在上面获取的 OAuth2 客户端 ID 和 OAuth2 客户端密钥。

    Playground 设置

  5. 在标有第 1 步 - 选择并授权 API 的部分中，点击列表中的 Search Ads 360 Reporting API，然后选择其范围 https://www.googleapis.com/auth/doubleclicksearch。然后点击授权 API：

    授权 API

  6. 如果出现提示，请登录您希望为其授予访问权限和授权的账号。否则，请确认右上角的当前用户是您要为其获取凭证的客户账号或经理账号。

  7. 系统会显示一条提示，指出您的应用想要管理您的 Search Ads 360 广告系列。点击接受以继续。

  8. 在标记为 Step 2 - Exchange authorization code for tokens 的标签中，应该会显示 Authorization code。点击将授权代码转换为令牌。

    Playground 授权代码令牌

  9. 如果一切顺利，系统应该已为您填写 Refresh token 和 Access token（您可能需要重新展开 Step 2 - Exchange authorization code for tokens 查看这些值）：

    Playground 刷新令牌

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

  11. 在 Search Ads 360 Reporting API 中为 OAuth 配置客户端库。

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

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

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

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

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

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

  5. 点击保存。