はじめに

Apache Maven（または Gradle）でクライアント ライブラリを使用することをおすすめします。

新しい Maven/Gradle プロジェクトを作成する

任意の IDE で新しい Maven/Gradle プロジェクトを作成します。私たちのアーティファクトは、 Maven セントラルに リポジトリをご覧ください。

Maven の依存関係は次のとおりです。

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>33.0.0</version>
</dependency>

Gradle の依存関係は次のとおりです。

implementation 'com.google.api-ads:google-ads:33.0.0'

ソースからビルドすることもできます。ここでは、 必要な依存関係を含むプロジェクト設定があることを前提としています。 できます。

API で認証するための認証情報を取得する

Google Ads API にアクセスするには、OAuth 認証情報と Google Ads API デベロッパーが必要です あります。このセクションでは、コンバージョン トラッキングの概要と使用方法、および使用方法について説明します。 取得します。

開発者トークン（API へのアクセス用）

開発者トークンがマネージャーにリンクされています。 Google 広告の管理画面から確認できます。

開発者トークンは MCC アカウントにリンクされますが、 アカウントへのアクセスを許可します。代わりに開発者トークンは 認証を行い、アカウント レベルのアクセスは OAuth を通じて設定します。

OAuth 認証情報（Google 広告アカウントへのアクセス用）

Google 広告アカウントへのアクセス権を持つ Google アカウント ユーザーとして承認するには、 一連の OAuth 認証情報を提供する必要があります。

一般的に使用される OAuth フローは 2 つあります。それはデスクトップ（インストールされる）アプリです。 ウェブ アプリケーションで利用できます。この 2 つの主な違いは、デスクトップ アプリは システム ブラウザを開き、ローカル リダイレクト URI を指定して Google の承認サーバーですが、ウェブアプリは任意の 使用して認証を完了し、認証情報をクライアントに返送します。 必要があります。このライブラリは、あまり使用されていないサービス アカウントも できます。

独自の認証情報を使用して承認する場合（デスクトップ アプリのフロー）
OAuth デスクトップ アプリ フローをご覧ください。これには 独自の認証情報で承認する必要はありません。
サードパーティの Google ユーザーとして承認している場合（ウェブフロー）
OAuth ウェブアプリのフローをご覧ください。この は、任意の第三者に対して OAuth 認証を設定する方法の例を示しています。 ユーザーです。
Google Apps ドメイン ユーザーとして承認する場合（サービス アカウントのフロー）
OAuth サービス アカウントを参照 フローをご覧ください。これは、この例で、 Google Apps ドメイン ユーザーの OAuth 認証を設定する。

Google 広告のお客様アカウントへのアクセス権が付与されているのが Google 広告のクライアント センター（MCC）アカウントの場合 下記の説明のように、ログイン用のお客様 ID も指定する必要があります。

ログイン用のお客様 ID（クライアント センター（MCC）アカウントから Google 広告アカウントにアクセスする場合）

必要に応じて、アクセス権を付与する MCC アカウントのお客様 ID を指定します 配信アカウント。販売パートナーが顧客にアクセスできる場合は、 クライアント センター（MCC）アカウントを通じて作成されている。すべてのマネージャーを指定する必要はありません。 お客様 ID へのパス上にある、最上位の MCC ID のみ ユーザーに付与します詳しくは、関連する ドキュメントをご覧ください。

認証情報を使用してクライアント ライブラリを構成する

構成ファイルを使用してクライアント ライブラリを構成するか、 作成する方法です。このガイドでは、 デスクトップとウェブのフローに焦点を当てます。使用 構成ファイルが推奨されるアプローチとしては、 （1 人のマネージャーの下でアカウントを管理する場合など）。

次の内容の ~/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

プレースホルダを前の手順で取得した認証情報に置き換えます。

また、更新トークンが MCC アカウント用である場合は、 ログインするお客様としてこのアカウントのお客様 ID を指定します。

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

認証情報を検証する

設定に問題がないか確認するために、Google は GetCampaigns を実行します。 例をご覧ください。

まず、google-ads-examples ディレクトリに移動します。

$ cd google-ads-examples

この例では、--customerId パラメータが必要です。ここで、値は Google 広告アカウントのお客様 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'