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>48.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 呼び出しを行う

Google Ads API を使用するには、いくつかの手順に沿って API へのアクセス権を取得し、Google 広告アカウントを設定する必要があります。クイック スタート ガイドに沿って、Google 広告アカウントの設定など、重要な手順をすべて完了します。

基本的な使用方法

プロジェクトの設定方法、サービス クライアントのインスタンス化方法、Java クライアント ライブラリを使用したコード例の実行方法については、基本的な使用ガイドをご覧ください。

認証と認可

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

構成とロギング

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

ユーティリティ

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

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

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

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