OAuth 桌面和 Web 应用流程

本指南将引导您逐步了解如何使用自己的凭据和桌面流程或网站流程设置 OAuth 2.0 以访问 API。除非您撤消、删除或需要更改 OAuth 2.0 凭据的允许范围，否则只需执行一次这些步骤。

创建 OAuth 2.0 凭据

按照相应步骤为 Google Ads API 配置 Google API 控制台项目。
记下客户端 ID 和客户端密钥，然后返回本页。

设置客户端库

在终端中，运行 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}
```
此代码示例会提示您访问一个网址，您必须在该网址授权该应用代表您访问您的 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 同意屏幕上的继续。

系统会将您转到一个页面，其中会显示一条消息，指明授权已成功。
```
Authorization code was successfully retrieved.
```

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

Replace the following keys and values in your googleads.properties configuration file:

clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****

按 Ctrl + C 终止进程。然后，将生成的刷新令牌以及客户端 ID 和客户端密钥复制到 googleads.properties 文件中，或者将其保存到其他位置以供在运行时实例化库时使用。