此页面由 Cloud Translation API 翻译。

OAuth 桌面和 Web 应用流程

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

创建 OAuth2 凭据

按照相应步骤为 Google Ads API 配置一个 Google API 控制台项目。
记下客户端 ID 和 Secret，然后返回此页面。

设置客户端库

在终端中，前往 OAuth2 示例。
- generate_user_credentials.pl
使用命令行运行此示例。您可以在运行之前修改示例中的 INSERT_XXX_HERE 值，也可以对客户端 ID 使用参数 -client_id，对客户端密钥使用 -client_secret 参数。
```
perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}
```
该示例会提示您访问一个网址，您将需要允许 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 同意屏幕上的继续。
然后，系统会将您转到一个页面，该页面会显示一条指示授权成功的消息。
```
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 中，或将其保存在其他位置，以便在运行时实例化库时使用。