OAuth 桌面和 Web 应用流程

本指南将引导您完成以下操作：使用您自己的凭据，通过桌面流程或Web 流程设置 OAuth 2.0 以进行 API 访问。除非您撤消、删除或需要更改 OAuth 2.0 凭据的允许范围，否则这些步骤只需执行一次。

创建 OAuth 2.0 凭据

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

  2. 先点击客户端的 Download OAuth client（下载 OAuth 客户端）图标，然后在随即显示的界面上点击 DOWNLOAD JSON（下载 JSON）按钮，下载客户端的 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. 此代码示例会提示您访问某个网址，您必须在该网址中授权应用代表您访问您的 Google Ads 账号。

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

    在无痕浏览器会话或无痕式窗口中访问该网址。 使用您用于访问 Google Ads 的 Google 账号登录。通常，这是 Google Ads 经理账号的登录电子邮件地址，该账号的账号层次结构中包含您需要管理的所有账号。在 OAuth 2.0 权限请求页面上点击继续。

    OAuth 2.0 权限请求页面

    系统会将您转到相应页面，其中会显示一条消息，表明授权成功。

    Your refresh token has been fetched. Check the console output for further instructions.

  3. 返回到运行代码示例的控制台。您会看到代码示例已完成，并显示您的刷新令牌和一些说明，后面是您需要遵循的说明，以配置客户端库：

    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