OAuth 桌面和 Web 应用流程

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

创建 OAuth2 凭据

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

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

设置客户端库

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

   • generate_user_credentials.pl

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 中，或者将其保存在其他地方（如果在运行时实例化库的话）。