ReachPlanService へのリクエストでは、承認済みの開発者トークン、OAuth 認証情報、OAuth 認証情報でアクセスできるお客様 ID を指定する必要があります。
このガイドでは、ReachPlanService に固有の認証の詳細について説明します。まだ行っていない場合は、まずスタートガイドの手順を完了してから、この手順に戻ってください。
開発者トークンと OAuth 認証情報
スタートガイドに記載されているガイダンスに加えて、次の点に注意してください。
ReachPlanServiceに接続するには、他の Google Ads API サービスでの使用がすでに承認されている場合でも、開発者トークンを適切な許可リストに追加する必要があります。詳しくは、資格要件をご覧ください。- Google Ads API に接続するには、Google Ads API 利用規約に同意する必要があります。
- OAuth 更新トークンを所有するユーザーによって、
ReachPlanServiceでクエリできる顧客 ID が決まります。これは統合に影響するもので、以降のセクションで詳しく説明します。
お客様 ID
Google Ads API 内のほとんどのサービスは、特定の Google 広告アカウントとキャンペーンで動作します。そのため、ほとんどのリクエストでは、管理またはクエリを行うアカウントを識別するためのお客様 ID と、そのお客様 ID にアクセスする権限を持つ OAuth 認証情報の両方が必要になります。ただし、ReachPlanService は、キャンペーンを実施する特定の顧客 ID がわかっていない段階で実施される動画プランニング アクティビティを対象としています。
内部ツール
組織内で使用するツールを構築する場合は、次の推奨事項をご覧ください。
クライアント アカウントに直接アクセスできないプランナー
プランナーがクライアントの Google 広告アカウントにアクセスできない場合は、デベロッパー トークンのマネージャー アカウントにアクセスできるユーザーのシングル ユーザー認証フローを使用して OAuth 認証情報を生成します。次に、ツールを使用するチームごとに Google 広告アカウントを作成または取得し、MCC アカウントにリンクします。ReachPlanService にリクエストを行う場合は、ユーザーのチームに対応する顧客 ID を指定します。
クライアント アカウントにアクセスできるプランナー
プランナーがクライアントのアカウントを管理する Google 広告クライアント センター（MCC）アカウントにアクセスできる場合は、マルチユーザー認証フローを実装して、アプリがプランナーの OAuth 認証情報を使用できるようにします。その後、プランの顧客に対応する顧客 ID を渡すことができます。
外部ツール
外部ユーザー向けのツールを構築する場合は、同様のアプローチをおすすめします。
クライアント アカウントごと
デベロッパー トークンのクライアント センター（MCC）アカウントにアクセスできるユーザーの単一ユーザー認証フローを使用して、OAuth 認証情報を生成します。外部クライアントごとに Google 広告アカウントを作成し、MCC アカウントにリンクします。次に、プランの生成時にクライアントの対応する顧客 ID を提供するようにツールを構成します。
ユーザー付与アクセス
マルチユーザー認証フローを使用して、ユーザーがツールにアカウントへのアクセス権を付与できるようにします。ユーザーが権限を付与したら、CustomerService を使用して、アクセス可能な Google 広告アカウントのリストを提供します。
この機能の目標は、プランナーが ReachPlanService を使用する際の摩擦を可能な限り軽減することです。API を統合する前に、状況に応じて 2 つのアプローチのいずれかを選択し、テストする顧客 ID をいくつか特定します。判断に迷った場合は、ツールタイプに最初に提案されたアプローチを使用してください。
次のステップ
詳しくは、メディアプランを指定する方法をご覧ください。