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