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

このステップでは、API 呼び出しを行う Google 広告アカウントを特定します。アカウントは、本番環境(ライブ)アカウントまたはテスト アカウントのいずれかになります。それぞれにメリットとデメリットがあります。

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

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

別の方法として、テスト アカウントでサポートされていない機能をテストするために、アカウント予算を 1 日あたり $1 などに設定した本番環境アカウントを明示的に作成することもできます。

機能セットの選択

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

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

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

ログイン用お客様 ID とお客様 ID を特定する

Google 広告のお客様に API 呼び出しを行うには、サービス アカウントに、お客様のアカウントへのアクセス権と適切な権限を直接付与するか、リンクされた MCC アカウント経由で付与する必要があります。この操作を行うには、お客様のアカウントの管理者権限が必要です。

まず、管理者として Google 広告アカウントにログインします。場合によっては、選択できるお客様のアカウントが複数あることがあります。選択したアカウントによってログインのお客様 ID が設定されます。これは、一部の API 呼び出しで必要なヘッダーです。

API 呼び出しを行う Google 広告のお客様を特定したら、次の詳細をメモします。

  • API 呼び出しを行う予定のお客様アカウントの 10 桁のお客様 ID。これは、運用顧客と呼ばれることもあります。

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

サービス アカウントへのアクセスを許可する

  1. 管理者として Google 広告アカウントにログインした状態で、[管理者] > [アクセスとセキュリティ] に移動します。

  2. [ユーザー] タブの [+] ボタンをクリックします。

  3. [メール] 入力ボックスにサービス アカウントのメールアドレスを入力します。アカウントのアクセス権限の適切なレベルを選択し、[アカウントを追加] ボタンをクリックします。サービス アカウントではメールのアクセスレベルはサポートされていません。

  4. サービス アカウントにアクセス権が付与されます。

デフォルトでは、サービス アカウントに管理者権限を付与することはできません。API 呼び出しに管理者権限が必要な場合は、次のようにアクセス権をアップグレードできます。

  1. [アクセスレベル] 列で、サービス アカウントのアクセスレベルの横にあるプルダウン矢印をクリックします。

  2. プルダウン リストから [管理者] を選択します。