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