Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Authentication

ReachPlanService へのリクエストでは、OAuth 認証情報と、OAuth 認証情報がアクセスできるお客様 ID を指定する必要があります。また、OAuth 認証情報に関連付けられた Google Cloud プロジェクトが、このサービスの使用を承認されている必要があります。

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

OAuth 認証情報

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

ReachPlanService に接続するには、Google Cloud プロジェクト番号を適切な許可リストに追加する必要があります。これは、他の Google Ads API サービスでの使用がすでに承認されている場合でも同様です。詳しくは、資格要件をご覧ください。
Google Ads API に接続するには、Google Ads API の利用規約に同意する必要があります。
OAuth 更新トークンを所有するユーザーによって、ReachPlanService でクエリできるお客様 ID が決まります。これは統合に影響します。詳細については、以降のセクションをご覧ください。

Google Ads API 内のほとんどのサービスは、特定の Google 広告アカウントとキャンペーンで動作します。そのため、ほとんどのリクエストでは、ターゲットアカウントを識別するお客様 ID と、そのお客様 ID へのアクセスを許可された OAuth 認証情報の両方が必要になります。

ただし、ReachPlanService は、キャンペーンを実施するための特定のお客様アカウントを設定する前に行われる動画プランニングアクティビティを対象としています。

組織内で使用するツールを構築する場合は、次のオプションを検討してください。

クライアントアカウントに直接アクセスできないプランナー: プランナーがクライアントの Google 広告アカウントにアクセスできない場合は、マネージャーアカウントにアクセスできるユーザーのシングルユーザー認証フローを使用して OAuth 認証情報を生成します。次に、ツールを使用するチームごとに Google 広告アカウントを作成または取得し、マネージャーアカウントにリンクします。ReachPlanService にリクエストを送信するときは、ユーザーのチームに対応するお客様 ID を指定します。
クライアントアカウントにアクセスできるプランナー: プランナーがクライアントのアカウントを管理する Google 広告 MCC アカウントにアクセスできる場合は、マルチユーザー認証フローを実装して、アプリケーションがプランナーの OAuth 認証情報を使用できるようにします。その後、顧客プランに対応するお客様 ID を渡すことができます。

サードパーティユーザーまたは外部ユーザー向けのツールを構築する場合は、次のオプションをおすすめします。

クライアントアカウントごと: マネージャーアカウントへのアクセス権を持つユーザーのシングルユーザー認証フローを使用して、OAuth 認証情報を生成します。外部クライアントごとに Google 広告アカウントを作成し、MCC アカウントにリンクします。プランの生成時にクライアントの対応するお客様 ID を提供するようにツールを構成します。
ユーザーが付与するアクセス権: マルチユーザー認証フローを使用して、ユーザーがツールにアカウントへのアクセス権を付与できるようにします。ユーザーが権限を付与したら、CustomerService を使用して、ユーザーがアクセスできる Google 広告アカウントのリストを取得します。

API を統合する前に、システム要件に基づいて上記のアプローチのいずれかを選択し、テスト用のお客様 ID をいくつか特定します。不明な点がある場合は、リンクされたアカウントを使用した単一ユーザー認証フローから始めてください。