共有エイリアス

Google Ads API を使用する場合、メールアドレスは連絡先とアクセス管理のために複数の場所で使用されます。最も重要なものは次のとおりです。

  • Google Ads API の連絡先メールアドレス: Google Cloud プロジェクトでオーナーまたは編集者のロールが割り当てられているメールアドレス。Google は、このメールアドレスを使用して、サービスに関する重要なお知らせ(MSA)と管理通知を送信します。
  • Google Cloud コンソール アカウントのメールアドレス: OAuth 2.0 アプリケーションに使用される Google Cloud プロジェクトへの管理者アクセス権を持つメールアドレス。
  • Google 広告 MCC アカウントへのアクセス権: Google Ads API を介してアクセスされる Google 広告 MCC アカウントへのアクセス権を持つサービス アカウント(推奨)または共有メール エイリアス。

このガイドの残りの部分では、前述の各アカウントと、統合が個々のユーザーのメールアドレスに依存しないように構成する方法について詳しく説明します。

Google Ads API の連絡先メールアドレス

Google は、管理通知、API レビューの更新、監査リクエスト、サービスに関する重要なお知らせ(MSA)、本番環境の緊急通信を、Google Cloud プロジェクトのオーナーロールと編集者ロールに関連付けられたメールアドレスに送信します(新しい API 連絡先メールアドレスをご覧ください。Google 広告 UI の以前の API センターの連絡先メールアドレス設定は廃止されました)。

連絡先メールアドレスを更新し、チーム全体がこれらの通知を受け取れるようにするには、Google Cloud プロジェクトの共有チーム エイリアスにオーナーまたは編集者のロールを付与し、そのエイリアスに送信されたメールを定期的に確認します。

Google Cloud コンソール アカウント

Google Cloud コンソール プロジェクトには、アプリケーションの OAuth 認証情報が含まれており、Google Ads API へのアクセスを制御します。共有チーム エイリアスにオーナー(または編集者)ロールを付与して、このプロジェクトへのアクセスを確保します。

共有エイリアスを Google Cloud プロジェクト オーナーとして追加する手順は次のとおりです。

  1. Google Cloud コンソールにログインします。
  2. ページの上部にあるプロジェクト セレクタからプロジェクトを選択します。
  3. ナビゲーション メニューで、[IAM と管理] > [IAM] に移動します。
  4. [アクセス権を付与] をクリックします。
  5. [プリンシパルの追加] セクションの [新しいプリンシパル] フィールドに、共有メールアドレスを入力します。
  6. [ロールを割り当てる] セクションで、[ロールを選択] をクリックし、[基本] > [オーナー](または [基本] > [編集者])を選択します。
  7. [保存] をクリックします。Google Cloud 組織外のメールアドレス(または組織のないプロジェクト)にオーナーロールを付与した場合、Google Cloud は共有エイリアスに招待メールを送信します。この招待を承認すると、ロールが有効になります。アクセス権の付与と取り消しの詳細については、Cloud のドキュメントをご覧ください。

Google 広告クライアント センター(MCC)アカウント(# または Google 広告 MCC アカウント)

Google Ads API を使用してアカウントを管理する一般的な方法は、すべてのアカウントを共通のマネージャー アカウントにリンクし、最上位のマネージャー アカウントの認証情報を使用してすべてのアカウントに対して API 呼び出しを行うことです。この構成では、デベロッパーは login-customer-id リクエスト ヘッダー(または login_customer_id クライアント ライブラリ構成設定)を Google 広告 MCC アカウントの 10 桁のお客様 ID(ハイフンなし)に設定し、ターゲット customer_id を API 呼び出しが行われるオペレーティング アカウントに設定します。

推奨: サービス アカウントを使用する

Google 広告 MCC アカウントの認証とアクセスには、サービス アカウントを使用することをおすすめします。個々のユーザー アカウントとは異なり、サービス アカウントは Google Cloud プロジェクト内で管理され、特定のユーザーに関連付けられていないため、チームメンバーがロールを変更したり、退職したりしても、サービスが停止することはありません。サービス アカウント ガイドに沿ってサービス アカウントを作成し、Google 広告マネージャー アカウントへのアクセス権を付与します。

代替手段: 共有メール エイリアスを使用する

統合でサービス アカウントを使用できず、代わりに単一ユーザー認証ワークフローに依存している場合、Google 広告 MCC アカウントへのアクセス権を持つユーザーが OAuth 2.0 更新トークンを発行します。

ユーザー認証情報を使用する際にこのシナリオを回避するには:

  1. 適切なアクセスレベルでこの Google 広告 MCC アカウントを管理するには、共有メール エイリアス(パスキー認証が有効になっているアクティブな Google アカウントに関連付けられているもの)を招待します。
  2. 共有メール エイリアスを使用して招待を承諾します。
  3. この共有メール エイリアスを使用して、API 呼び出しを行うための OAuth 更新トークンを発行します。