OAuth 桌面和 Web 应用流程

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

创建 OAuth2 凭据

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

  2. 记下客户端 ID密钥,然后返回此页面。

设置客户端库

  1. 在终端中,导航到 OAuth2 示例。

  2. 使用命令行运行此示例。您可以在运行前修改示例中的 INSERT_XXX_HERE 值,也可以使用 -client_id 作为客户端 ID 的参数,并使用 -client_secret 作为客户端密钥的参数。

    perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}
    
  3. 该示例会提示您访问一个网址,您需要在该网址中允许 OAuth2 凭据代表您访问您的 Google Ads 账号。

    Paste this url in your browser:
    https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...
    

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

    同意屏幕

  4. 然后,您会进入一个页面,其中显示一条消息,指明授权已成功。

    Authorization code was successfully retrieved.
    

    您会看到该示例已完成,并在同一页面中看到您的刷新令牌以及一些说明,后面跟着您配置客户端库所需的属性:

    Replace the following keys and values in your googleads.properties configuration file:
    
    clientId==***********************apps.googleusercontent.com
    clientSecret=****
    refreshToken=****
    
  5. 返回运行示例的控制台,然后按 Ctrl + C 终止进程。然后,将生成的刷新令牌连同客户端 ID 和客户端密钥复制到您的 googleads.properties 中,或将其保存到其他位置,以便在运行时实例化库时使用。