本指南介绍了如何使用您自己的凭据以及桌面流程或网页流程设置 OAuth2 以进行 API 访问。这些步骤只需执行一次,除非您撤消、删除 OAuth2 凭据或需要更改 OAuth2 凭据的允许范围。
创建 OAuth2 凭据
下载客户端的 JSON 文件,具体方法是首先点击客户端的下载 OAuth 客户端图标,然后在接下来显示的屏幕上点击下载 JSON 按钮。
将文件保存到主目录,您现在拥有了本地文件
~/client_secret_XXX.apps.googleusercontent.com.json
(其中 XXX 是特定于您的项目的值)。我们将在下一步中使用此文件运行代码示例。
设置客户端库
在终端中,运行
GenerateUserCredentials
示例。使用命令行标志向其传递您在上一步中下载的 JSON 文件。使用 Gradle 从命令行运行
./gradlew --console=plain --quiet runExample \ --example="authentication.GenerateUserCredentials \ --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
该示例将提示您访问一个网址,您需要允许 OAuth2 凭据代表您访问您的 Google Ads 帐号。
Paste this URL in your browser: https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
在无痕浏览器会话或无痕式窗口中访问该网址。 通过您访问 Google Ads 时所用的 Google 帐号登录。点击 OAuth2 同意屏幕上的继续。
您将转到一个页面,其中显示一条表明授权成功的消息。
已成功检索到授权代码。
查看
GenerateUserCredentials
的控制台输出,获取进一步说明。返回您运行示例的控制台。您将看到该示例已完成,并显示您的刷新令牌和一些说明,以及配置客户端库所需的属性:
#Mon Apr 18 09:07:51 EDT 2022 api.googleads.refreshToken=1/Yw......................................... api.googleads.clientId=...........-...............apps.googleusercontent.com api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE api.googleads.clientSecret=........................
将日期注释
#
到输出末尾的几行内容复制到ads.properties
文件中。将
INSERT_DEVELOPER_TOKEN_HERE
替换为您的开发者令牌。为最简单的设置,请将
ads.properties
文件放在主目录中。