お客様のアカウントを準備する

このステップでは、API 呼び出しを行う Google 広告アカウントを指定します。OAuth 2.0 更新トークンを生成するには、そのメールアドレスが必要です。アカウントは、本番環境(ライブ)アカウントまたはテスト アカウントのいずれかです。それぞれに長所と短所があります

本番環境アカウント
テスト アカウント
メリット
  • 特定のアカウント コンテンツに対して機能するコードの記述とテストが容易になる。
  • ライブレポートデータを処理するコードの記述とテストが容易になる。
  • テスト アカウントでは広告が配信されません。そのため、プログラミングでバグが発生しても、運用中のキャンペーンには影響しません。
  • テストアクセスレベルを持つ開発者トークンと連携します。
デメリット
  • 開発段階にあるプログラミングのバグは、キャンペーンの配信中に影響し、キャンペーンのパフォーマンスの低下、不適切な配信、金銭的な損失などの問題につながる可能性があります。
  • API 呼び出しを行うには、少なくともベーシック アクセスレベルが開発者トークンに付与されている必要があります。
  • 特定のアカウント コンテンツに対して機能するコードをテストするには、テスト アカウント内でキャンペーンを再構築する必要があります。
  • テスト アカウントでは広告が配信されないため、統計情報の報告、ポリシー違反エラー、オフライン コンバージョンのインポートの処理など、ライブ配信に関連する機能はサポートされていないため、これらの機能のテストは困難です。

可能であれば、アプリケーションの開発中はテスト アカウントを使用することをおすすめします。手順については、テスト アカウントとテスト キャンペーンを作成するをご覧ください。

あるいは、テスト アカウントでサポートされていない機能のテスト用に、1 日 1 ドルなど、低予算で本番環境アカウントを設定することもできます。

機能セットの選択

API 呼び出しを行うアカウントを選択する際は、API で使用する機能のリストも考慮する必要があります。本番環境アカウントを使用する場合でも、次のようなアカウント固有の機能を使用できます。

  • 請求機能を利用するには、毎月の請求書発行によるお支払いのアカウントが必要です。
  • 一部の新機能は、許可リストに登録されたアカウントのリストに限定される場合があります。

API 呼び出しを行うアカウントを確定する前に、その機能のドキュメントを参照して、その機能に追加の制限がないことを確認してください。

ユーザー アクセス、ログイン用のお客様 ID、お客様 ID

Google 広告の顧客に対して API 呼び出しを行うには、その顧客に直接アクセスするか、リンクされた MCC アカウント経由でアクセスする必要があります。また、特定の API 呼び出しに応じて適切な権限が必要になります。

Google 広告にログインする際は、複数の顧客アカウントから選択できます。選択したアカウントにより、ログインのお客様 ID(一部の API 呼び出しでは必須ヘッダー)とアクセスレベルが設定されます。

API 呼び出しを行う Google 広告ユーザーを特定したら、次の詳細情報に注意してください。

  • API 呼び出しの対象とするお客様アカウントの 10 桁のお客様 ID。運用顧客と呼ばれることもあります。

  • 現在ログインしているお客様のアカウントのメールアドレス。これは、OAuth 2.0 更新トークンを生成するために必要です。

  • 現在ログインしているお客様のアカウントの 10 桁のログイン用お客様 ID。 OS のお客様にログインしている場合、ログインのお客様 ID はお客様 ID と同じです。