このページは Cloud Translation API によって翻訳されました。

はじめに

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'