本指南将引导您完成以下操作:使用您自己的凭据,通过桌面流程或Web 流程设置 OAuth 2.0 以进行 API 访问。除非您撤消、删除或需要更改 OAuth 2.0 凭据的允许范围,否则这些步骤只需执行一次。
创建 OAuth 2.0 凭据
先点击客户端的 Download OAuth client(下载 OAuth 客户端)图标,然后在随即显示的界面上点击 DOWNLOAD JSON(下载 JSON)按钮,下载客户端的 JSON 文件。
将该文件保存到您的主目录,这样您现在就拥有了本地文件
~/client_secret_XXX.apps.googleusercontent.com.json
(其中 XXX 将是特定于您项目的值)。我们将在下一步中使用此文件来运行代码示例。
设置客户端库
在终端中,运行
您可以使用以下命令通过 Gradle 从命令行运行代码示例:GenerateUserCredentials
代码示例。使用命令行标志将您下载的 OAuth 2.0 JSON 文件传递给它。./gradlew --console=plain --quiet runExample \ --example="authentication.GenerateUserCredentials \ --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
此代码示例会提示您访问某个网址,您必须在该网址中授权应用代表您访问您的 Google Ads 账号。
Paste this URL in your browser: https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
在无痕浏览器会话或无痕式窗口中访问该网址。使用您用于访问 Google Ads 的 Google 账号登录。通常,这是 Google Ads 经理账号的登录电子邮件地址,该经理账号的账号层次结构中包含您需要管理的所有账号。在 OAuth 2.0 权限请求页面上点击继续。
系统会将您转到相应页面,其中会显示一条消息,表明授权成功。
Authorization code was successfully retrieved. Check the console output from `GenerateUserCredentials` for further instructions.
-
返回到您运行代码示例的控制台。您会看到代码示例已完成,并显示您的刷新令牌和一些说明,接下来是您需要遵循的说明,以配置客户端库:
#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
文件放在您的主目录中。