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