适用于 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>48.0.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 调用

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

基本用法

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

身份验证和授权

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

配置和日志记录

Java 客户端库支持多种 配置选项 （包括 ads.properties 文件、环境变量和以编程方式进行 配置），以及用于跟踪 API 请求和响应的 日志记录功能。

实用程序

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

  • FieldMasks：用于构建 和计算更新字段掩码的帮助程序。
  • ResourceNames：用于 格式化实体资源名称字符串的实用程序。
  • 长时间运行的操作：用于 监控和管理异步 API 操作的帮助程序。

优化应用

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