适用于 Java 的 Google Ads API 客户端库

Java 版客户端库托管在 GitHub 上，并通过 Maven Central 进行分发。它提供多项功能来帮助您使用该 API，包括更轻松地管理凭据和创建 Google Ads API 服务客户端。

该库需要 Java 8 或更高版本。

安装

在 pom.xml 或 build.gradle 文件中使用 Google Ads API 物料清单 (BOM) 来管理依赖项版本：

<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
     versions of all google-ads libraries. -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>google-ads-bom</artifactId>
      <version>46.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency, without a version. The version is
     managed by the BOM. -->
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
</dependency>

您还可以从源代码构建库。

进行首次 API 调用

视频库：Java 客户端库使用入门

如需使用 Google Ads API，您需要执行多个步骤才能获得该 API 的访问权限并配置 Google Ads 账号。请按照快速入门指南操作，该指南会引导您完成所有重要步骤，包括设置 Google Ads 账号。

基本用法

请参阅基本使用指南，了解如何使用 Java 客户端库设置项目、实例化服务客户端和运行代码示例。

身份验证和授权

Java 客户端库支持多种身份验证和授权方法，包括 OAuth 2.0 桌面应用和 Web 应用流程、服务账号和应用默认凭据。如需了解详情，请参阅身份验证和授权指南。

配置和日志记录

Java 客户端库支持多种配置选项（包括 ads.properties 文件、环境变量和程序化配置），并提供用于跟踪 API 请求和响应的日志记录功能。

实用程序

Java 客户端库包含实用程序类，可提高 API 的易用性。请参阅以下指南了解详情：

微调应用

如需有关如何微调应用的超时、重试设置、启动延迟时间和依赖项管理的建议，请参阅高级使用指南。