OAuth 桌面和 Web 应用流程

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

创建 OAuth 2.0 凭据

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

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

设置客户端库

  1. 在终端中,运行 generate_user_credentials.pl 示例。您可以先修改示例中的 INSERT_XXX_HERE 值,然后再运行,也可以使用命令行实参 -client_id(用于客户端 ID)和 -client_secret(用于客户端密钥)。

    perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}
    
  2. 此代码示例会提示您访问某个网址,您必须在该网址中授权应用代表您访问您的 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 账号登录。通常,这是 Google Ads 经理账号的登录电子邮件地址,该经理账号的账号层次结构中包含您需要管理的所有账号。在 OAuth 2.0 权限请求页面上点击继续

    OAuth 2.0 权限请求页面

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

    Authorization code was successfully retrieved.
    
  3. 返回到您运行代码示例的控制台。您会看到代码示例已完成,并显示您的刷新令牌和一些说明,接下来是您需要遵循的说明,以配置客户端库:

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