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

このステップでは、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。オペレーティング カスタマーにログインしている場合、ログインするお客様 ID はお客様 ID と同じです。