Authentication

ReachPlanService へのリクエストでは、承認済みのデベロッパー トークン、OAuth 認証情報、OAuth 認証情報でアクセスできる顧客 ID を指定する必要があります。

このガイドでは、ReachPlanService に固有の認証の詳細について説明します。まだ行っていない場合は、まずスタートガイドの手順を完了してから、この手順に戻ってください。

デベロッパー トークンと OAuth 認証情報

スタートガイドに記載されているガイダンスに加えて、次の点に注意してください。

1. 他の Google Ads API サービスでの使用がすでに承認されている場合でも、ReachPlanService に接続するには、デベロッパー トークンを許可リストに登録する必要があります。詳しくは、資格要件をご覧ください。
2. Google Ads API に接続するには、Google Ads API 利用規約に同意する必要があります。
3. OAuth 更新トークンを所有するユーザーによって、ReachPlanService でクエリできる顧客 ID が決まります。これはインテグレーションに影響します。詳しくは、以下をご覧ください。

お客様 ID

Google Ads API 内のほとんどのサービスは、特定の Google 広告アカウントとキャンペーンで動作します。そのため、ほとんどのリクエストでは、管理またはクエリするアカウントを特定するための顧客 ID と、その顧客 ID にアクセスする権限を持つ OAuth 認証情報の両方が必要になります。ただし、ReachPlanService は、キャンペーンを実施する特定の顧客 ID がわかっていない段階で実施される動画プランニング アクティビティを対象としています。

組織内で使用するツールを構築するパートナーには、次のいずれかの選択肢をおすすめします。

1. プランナーがクライアントの Google 広告アカウントにアクセスできない場合: デベロッパー トークンの MCC アカウントにアクセスできるユーザーのインストール型アプリケーション フローを使用して OAuth 認証情報を生成します。次に、ツールを使用するチームごとに Google 広告アカウントを作成または取得し、MCC アカウントにリンクします。ReachPlanService にリクエストを行う場合は、ユーザーのチームに対応する顧客 ID を指定します。

2. プランナーがクライアントのアカウントを管理する Google 広告のクライアント センター（MCC）アカウントにアクセスできる場合: ウェブ アプリケーション フローを実装して、プランナーの OAuth 認証情報を使用できるようにします。次に、プランの顧客に対応する顧客 ID を渡すことができます。

外部ユーザー向けのツールを構築するパートナーには、同様のアプローチをおすすめします。

1. デベロッパー トークンの管理者アカウントにアクセスできるユーザーのインストール済みアプリケーション フローを使用して OAuth 認証情報を生成します。外部クライアントごとに Google 広告アカウントを作成し、MCC アカウントにリンクします。次に、クライアントがプランを生成するときに、対応する顧客 ID を提供するようにツールを構成します。

2. ウェブ アプリケーション フローを使用して、ユーザーがツールにアカウントへのアクセス権を付与できるようにします。ユーザーが権限を付与したら、CustomerService を使用して、アクセス可能な Google 広告アカウントのリストを提供します。

この機能の目標は、プランナーが ReachPlanService を使用する際の摩擦を可能な限り軽減することです。API を統合する前に、状況に応じて 2 つのアプローチのいずれかを選択し、テストする顧客 ID をいくつか特定します。判断に迷った場合は、ツールタイプに最初に提案されたアプローチを使用してください。