我们建议将客户端库与 Apache Maven（或 Gradle）搭配使用。
创建新的 Maven/Gradle 项目
在您选择的 IDE 中创建新的 Maven/Gradle 项目。我们的工件会发布到 Maven 中央代码库。
Maven 依赖项为：
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>29.0.0</version>
</dependency>
Gradle 依赖项为：
implementation 'com.google.api-ads:google-ads:29.0.0'
您也可以从源代码构建。在本指南中，我们假定您已完成具有所需依赖项的项目设置。
获取凭据以使用 API 进行身份验证
访问 Google Ads API 需要 OAuth 凭据和 Google Ads API 开发者令牌。本部分介绍了它们的定义、使用方式和获取方式。
开发者令牌（用于访问 API）
开发者令牌与经理帐号相关联，可在 Google Ads 网页界面中找到。
虽然开发者令牌与经理帐号相关联，但并不能提供对该帐号的访问权限。相反，开发者令牌会授予对 API 的常规访问权限，而帐号级访问权限通过 OAuth 配置。
OAuth 凭据（用于访问 Google Ads 账号）
如需向拥有 Google Ads 账号访问权限的 Google 账号用户授权，您必须提供一组 OAuth 凭据。
一般使用两种 OAuth 流程：桌面（安装）应用或 Web 应用。两者之间的主要区别在于，桌面应用必须打开系统浏览器并提供本地重定向 URI 来处理来自 Google 授权服务器的响应，而 Web 应用可以重定向任意第三方浏览器以完成授权并将凭据发送回您的服务器。该库还支持不太常用的服务帐号流程。
- 如果您使用自己的凭据进行授权（桌面应用流程）
- 请参阅 OAuth 桌面应用流程。其中包括使用自己的凭据进行授权所需的所有详细信息。
- 如果您授权成为第三方 Google 用户（网络流程）
- 请参阅 OAuth Web 应用流程。此示例展示了如何为任意第三方用户设置 OAuth 授权。
- 如果您授权为 Google Apps 网域用户（服务账号流程）
- 请参阅 OAuth 服务帐号流程。此示例展示了如何为 Google Apps 网域用户设置 OAuth 授权。
如果您通过 Google Ads 经理帐号访问 Google Ads 客户帐号，您还必须指定登录客户 ID，如下所述。
登录客户 ID（用于通过经理账号访问 Google Ads 账号）
（可选）指定有权访问广告投放账号的经理账号的客户 ID。如果您通过经理帐号访问客户帐号，则必须指定此属性。无需在客户 ID 路径中指定所有经理帐号，只需指定您用于访问权限的最高经理帐号 ID。如需了解详情，请参阅相关文档。
使用您的凭据配置客户端库
您可以使用配置文件、环境变量或以编程方式配置客户端库。在本指南中，我们将使用配置文件方法，并着重介绍桌面流程和 Web 流程。如果您只有一组凭据（例如，您可以在一个经理帐号下管理帐号），则通常来说，使用配置文件是一种不错的方法。
创建一个包含以下内容的 ~/ads.properties 文件。
api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
将占位符替换为您在上一步中获得的凭据。
此外，如果您的刷新令牌用于经理帐号，则应将此帐号的客户 ID 指定为登录客户：
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE
验证凭据
为确保所有设置正确无误，我们将运行 GetCampaigns 示例。
首先，进入 google-ads-examples 目录。
$ cd google-ads-examples
此示例需要 --customerId 参数，其值为不带短划线的 Google Ads 帐号客户 ID。
如需使用 Gradle 运行，请执行以下操作：
$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
浏览其他示例
google-ads-examples 中的 examples 软件包提供了一些有用的示例。大多数示例都需要参数。您可以将参数作为实参传递（推荐），也可以修改源代码中的 INSERT_XXXXX_HERE 值。如需查看示例的用法语句，请将 --help 作为唯一参数传递。
使用 Gradle：
$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
您还可以使用 Gradle 中的 listExamples 任务列出所有示例、子目录中的示例或在说明中包含搜索字词的示例。
# List all examples:
$ ./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
$ ./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
$ ./gradlew -q listExamples --searchTerm='Performance Max'