ReachPlanService
へのリクエストでは、承認済みの開発者トークン、OAuth 認証情報、OAuth 認証情報がアクセスできるお客様 ID を指定する必要があります。
このガイドでは、ReachPlanService
に固有の認証の詳細について説明します。まだ行っていない場合は、まず使ってみるに記載されている手順を完了してから、ここに戻ってください。
開発者トークンと OAuth 認証情報
スタートガイドで提示されたガイダンスに加えて、以下の点に注意してください。
- 開発者トークンは、他の Google Ads API サービスでの使用がすでに承認されている場合でも、
ReachPlanService
に接続するには許可リストに登録されている必要があります。詳しくは、資格要件をご覧ください。 - Google Ads API に接続するには、Google Ads API 利用規約に同意する必要があります。
- OAuth 更新トークンを所有するユーザーが、
ReachPlanService
でクエリできるお客様 ID を決定します。これにより統合が通知されます。詳細については、下記をご覧ください。
お客様 ID
Google Ads API 内のほとんどのサービスは、特定の Google 広告アカウントとキャンペーンで動作します。そのため、ほとんどのリクエストでは、管理またはクエリ対象のアカウントを特定するためのお客様 ID と、そのお客様 ID へのアクセス権限を持つ OAuth 認証情報の両方が必要になります。ただし、ReachPlanService
は、キャンペーンを実施する具体的なお客様 ID が判明する前に行われる可能性がある動画プランニング アクティビティを対象としています。
組織内で使用するツールを構築するパートナーには、次のいずれかの選択肢をおすすめします。
プランナーがクライアントの Google 広告アカウントにアクセスできない場合: インストール型アプリケーションのフローを使用して、開発者トークンの MCC アカウントにアクセスできるユーザーの OAuth 認証情報を生成します。次に、ツールを使用するチームごとに Google 広告アカウントを作成または取得し、マネージャー アカウントにリンクします。
ReachPlanService
にリクエストを行う場合は、ユーザーのチームに対応するお客様 ID を指定します。プランナーが、クライアントのアカウントを管理する Google 広告 MCC アカウントにアクセスできる場合: ウェブ アプリケーションのフローを実装して、アプリでプランナーの OAuth 認証情報を使用できるようにします。次に、プランの顧客に対応する顧客 ID を渡します。
外部ユーザー向けのツールを構築するパートナーには、同様のアプローチをおすすめします。
インストール型アプリケーションのフローを使用して、開発者トークンの MCC アカウントにアクセスできるユーザーの OAuth 認証情報を生成します。外部クライアントごとに Google 広告アカウントを作成し、クライアント センター(MCC)アカウントにリンクします。次に、クライアントがプランを生成するときに、対応するお客様 ID を提供するようにツールを構成します。
ウェブ アプリケーションのフローを使用して、ユーザーがツールにアカウントへのアクセスを許可できるようにします。ユーザーが権限を付与したら、
CustomerService
を使用して、ユーザーがアクセスできる Google 広告アカウントのリストを提供します。
目標は、プランナーが ReachPlanService
を使用する際の負担をできる限り少なくすることです。API を統合する前に、状況に応じて 2 つのアプローチのいずれかを選択し、テストするお客様 ID をいくつか特定します。判断に迷う場合は、ツールタイプに対して最初に提案されたアプローチを使用してください。