OAuth 桌面和 Web 应用流程

本指南将向您介绍如何使用自己的凭据以及桌面流程网页流程设置 OAuth2 以进行 API 访问。除非您撤消、删除或需要更改 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