Java 用 Google Ads API クライアント ライブラリ

Java 用クライアント ライブラリは GitHub でホストされ、Maven Central を介して配布されます。このライブラリには、認証情報の管理の簡素化や Google Ads API サービス クライアントの作成など、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 広告アカウントを構成するための手順をいくつか行う必要があります。クイック スタートガイドに沿って、Google 広告アカウントの設定など、重要な手順をすべて完了してください。

基本的な使用方法

基本使用ガイドを参照して、Java クライアント ライブラリを使用してプロジェクトを設定し、サービス クライアントをインスタンス化して、コードサンプルを実行する方法を確認してください。

認証と認可

Java クライアント ライブラリは、OAuth 2.0 デスクトップ アプリケーション フローとウェブ アプリケーション フロー、サービス アカウント、アプリケーションのデフォルト認証情報など、認証と認可に対する複数のアプローチをサポートしています。詳細については、認証と認可のガイドをご覧ください。

構成とロギング

Java クライアント ライブラリは、複数の構成オプション（ads.properties ファイル、環境変数、プログラムによる構成など）と、API リクエストとレスポンスをトレースするためのロギング機能をサポートしています。

ユーティリティ

Java クライアント ライブラリには、API のユーザビリティを向上させるユーティリティ クラスが含まれています。詳細については、次のガイドをご覧ください。

  • FieldMasks: 更新フィールド マスクの構築と計算を行うヘルパー。
  • ResourceNames: エンティティ リソース名の文字列をフォーマットするためのユーティリティ。
  • 長時間実行オペレーション: 非同期 API オペレーションのモニタリングと管理を行うヘルパー。

アプリケーションを微調整する

アプリケーションのタイムアウト、再試行設定、起動レイテンシ、依存関係の管理を微調整する方法については、高度な使用ガイドをご覧ください。