Google Ads API を使用する場合、連絡先とアクセスの管理にメールアドレスを使用する場所が複数ありますが、中でも重要なのは次のうちどれですか。
- Google Ads API の連絡先メールアドレス: これは、Google 広告 UI の API センターに連絡先として登録されているメールアドレスです。
- Google Cloud Console アカウントのメールアドレス: OAuth 2.0 アプリケーションに使用される Google Cloud Console アカウントに対する管理者権限を持つメールアドレスです。
- Google 広告クライアント センター（MCC）アカウントのメールアドレス: Google Ads API を使用してアクセスする MCC アカウントに対する管理者権限を持つメールアドレスです。アプリケーションの更新トークンを生成するときは、通常、これらのいずれかのメールを使用して Google Ads API アプリケーションを認証します。
個々のチームメンバーがチームを切り替えたり退職したりしても、これらのアカウントにアクセスできなくなることのないよう、共有チームのエイリアスを使用することを強くおすすめします。このガイドの残りの部分では、前述の各メールの詳細と、個々のユーザーのメールアドレスではなく、共有チーム エイリアスを使用するように更新する方法について説明します。
Google Ads API: 連絡先メールアドレス
Google Ads API の連絡先メールアドレスは、Google Ads API の登録時に指定するメールアドレスです。このエイリアスにアクセスできることを確認し、このアドレスに送信されたメールを定期的にモニタリングしてください。Google は、API の審査時、監査リクエスト時、または早急な対応を必要とする本番環境での緊急事態の発生時に、このメールアドレスを使用してお客様のチームに連絡します。共有チーム エイリアスを連絡先メールアドレスとして使用して、チーム全体がこれらの通知を受け取れるようにします。
API の連絡先メールアドレスを更新する手順は次のとおりです。
- Google Ads API へのアクセス権の申請に使用した Google 広告 MCC アカウントにログインします。これは、開発者トークンが保存されているアカウントと同じです。
- [ツールと設定] > [API センター] に移動します。
- [API の連絡先メールアドレス] セクションの下にある矢印をクリックします。
- メールアドレスを更新し、[Save] ボタンをクリックします。
Google Cloud コンソール アカウント
Google API Console プロジェクトには、アプリケーションの OAuth 認証情報が含まれ、Google Ads API へのアクセスが制御されます。共有エイリアスをアカウント所有者にして、このアカウントにアクセスできるようにします。
Google API Console プロジェクトのオーナーを更新する手順は次のとおりです。
- Google API Console にログインします。
- ページの左上にあるプルダウン メニューからプロジェクトを選択します。
- 左側のメニューから [IAM と管理] > [IAM] に移動します。
- [アクセス権を付与] ボタンをクリックします。
- [プリンシパルの追加] セクションに共有メールアドレスを入力します。
- オーナーのロールを割り当てます。
- [Save] ボタンをクリックします。アクセス権の付与と取り消しの詳細については、Cloud のドキュメントをご覧ください。
Google 広告クライアント センター（MCC）アカウント（# または Google 広告 MCC アカウント）
Google Ads API を使ってアカウントを管理する一般的な方法は、共通の MCC アカウントの下ですべてのアカウントをリンクし、最上位の MCC アカウントの認証情報を使用してすべてのアカウントに API 呼び出しを行うことです。この設定は以下のようなものです。
- デベロッパーは、Google 広告 MCC アカウントにアクセスできるユーザーの認証情報を使用して更新トークンを発行します。
- デベロッパーは、
login_customer_idヘッダーを Google 広告 MCC アカウントのお客様 ID に設定し、customer_idヘッダーを API 呼び出しが行われるアカウントのお客様 ID に設定します。
この設定による潜在的なリスクの一つは、承認されたユーザーが Google 広告 MCC アカウントへのアクセス権を失うと、更新トークンが無効になり、すべての API 呼び出しが失敗することです。このような状況を回避するには、共有メール エイリアスを招待して、適切なアクセスレベルでこの Google 広告 MCC アカウントを管理します。この共有メール エイリアスを使用して、API 呼び出しを行うための更新トークンを発行します。