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 広告アカウントを作成または取得し、MCC アカウントにリンクします。
ReachPlanServiceにリクエストを送信する場合は、ユーザーのチームに対応するお客様 ID を指定してください。プランナーが、クライアントのアカウントを管理している Google 広告 MCC アカウントにアクセスできる場合: ウェブ アプリケーションのフローを実装して、プランナーの OAuth 認証情報をアプリが使用できるようにします。次に、プランの顧客に対応するお客様 ID を渡します。
外部ユーザー向けのツールを構築するパートナーには、同様のアプローチをおすすめします。
インストール済みアプリケーションのフローを使用して、開発者トークンの MCC アカウントにアクセスできるユーザーの OAuth 認証情報を生成します。外部クライアントごとに Google 広告アカウントを作成し、MCC アカウントにリンクします。次に、プランの生成時にクライアントに対応するお客様 ID を指定するようにツールを構成します。
ウェブ アプリケーション フローを使用して、ユーザーがツールにアカウントへのアクセス権を付与できるようにします。ユーザーが権限を付与したら、
CustomerServiceを使用して、そのユーザーがアクセスできる Google 広告アカウントのリストをユーザーに提供します。
目標は、プランナーが ReachPlanService を使用する際に負担を最小限に抑えることです。API を統合する前に、状況に応じて 2 つの方法のいずれかを選択し、テストするお客様 ID をいくつか特定します。判断に迷う場合は、ツールタイプに応じて最初に推奨される方法を使用してください。