OAuth Playground

生成 OAuth2 凭据的方法之一是使用 OAuth2 Playground。与 Google Ads API 控制台配合使用后，OAuth2 Playground 可让您手动创建 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。
    • Access type 设置为 Offline（这可确保您获得刷新令牌和访问令牌，而不只是访问令牌）。

  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. 点击保存。