OAuth 桌面和 Web 应用流程

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

创建 OAuth2 凭据

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

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

设置客户端库

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

   • generate_user_credentials.pl

2. 使用命令行运行此示例。您可以在运行前修改示例中的 INSERT_XXX_HERE 值，也可以为客户端 ID 使用参数 -client_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 中，或将其保存到其他位置，以便在运行时实例化库时使用。