OAuth 桌面和 Web 应用流程

本指南介绍了如何使用自己的凭据以及桌面流程网页流程设置 OAuth2 以进行 API 访问。除非您撤消、删除 OAuth2 凭据或需要更改 OAuth2 凭据允许的范围,否则这些步骤只需执行一次。

创建 OAuth2 凭据

  1. 按照相应步骤为 Google Ads API 配置一个 Google API 控制台项目

  2. 下载客户端的 JSON 文件,具体方法是首先点击客户端的下载 OAuth 客户端图标,然后在接下来显示的屏幕上点击下载 JSON 按钮。

    将文件保存到主目录,您现在拥有了本地文件 ~/client_secret_XXX.apps.googleusercontent.com.json(其中 XXX 是特定于您的项目的值)。我们将在下一步中使用此文件运行代码示例。

设置客户端库

  1. 在终端中,运行 generate_user_credentials 示例。使用命令行标志向其传递您在上一步中下载的 JSON 文件。

    generate_user_credentials.py \
      --client_secrets_path=${HOME}/client_secret_XXX.apps.googleusercontent.com.json
    
  2. 该示例会提示您访问一个网址,您将需要允许 OAuth2 凭据代表您访问您的 Google Ads 帐号。

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
    

    在无痕浏览器会话或无痕式窗口中访问该网址。 通过您访问 Google Ads 时所用的 Google 帐号登录。点击 OAuth2 同意屏幕上的继续

    意见征求屏幕

  3. 随后,您将转到一个显示授权成功的消息的页面。

    已提取您的刷新令牌。请查看控制台输出,了解进一步的操作说明。

  4. 返回到您运行该示例的控制台,它现在应该会显示您的刷新令牌和一些有关如何配置客户端库的说明:

    Your refresh token is: 1/Yw.........................................
    Add your refresh token to your client library configuration as described here:
    https://developers.google.com/google-ads/api/docs/client-libs/python/configuration