Google Ads API を使用する場合、連絡先とアクセスの管理にメールアドレスを使用する場所は複数ありますが、最も重要なのは次の場所です。
- Google Ads API の連絡先メールアドレス: Google 広告管理画面の API センターに連絡先として表示されるメールアドレスです。
- Google Cloud コンソール アカウントのメールアドレス: これは、OAuth 2.0 アプリケーションに使用する Google Cloud コンソール アカウントへの管理者権限を持つメールアドレスです。
- 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 の連絡先メールアドレス] にある矢印をクリックします。
- メールアドレスを更新して [保存] ボタンをクリックします。
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 呼び出し用の更新トークンを発行します。