ReachPlanService へのリクエストでは、OAuth 認証情報と、OAuth 認証情報でアクセスできる顧客 ID を指定する必要があります。また、OAuth 認証情報に関連付けられている Google Cloud プロジェクトが、このサービスの使用について承認されている必要があります。
このガイドでは、ReachPlanService 固有の認証の詳細について説明します。まだ行っていない場合は、まずスタートガイドの手順を完了してから、このガイドに戻ってください。
OAuth 認証情報
スタートガイドに記載されているガイダンスに加えて、次の点に留意してください。
- Google Cloud プロジェクト番号が、他の Google Ads API サービスでの使用がすでに承認されている場合でも、
ReachPlanServiceに接続するには、適切な許可リストに追加する必要があります。詳しくは、資格要件をご覧ください。 - Google Ads API に接続するには、Google Ads API 利用規約に同意する必要があります。
- OAuth 更新トークンを所有するユーザーによって、
ReachPlanServiceでクエリできる顧客 ID が決まります。これは統合に影響します。詳細については、以降のセクションで説明します。
お客様 ID
Google Ads API 内のほとんどのサービスは、特定の Google 広告アカウントとキャンペーンで動作します。そのため、ほとんどのリクエストでは、ターゲット アカウントを識別するための顧客 ID と、その顧客 ID へのアクセスが承認された OAuth 認証情報の両方が必要になります。
ただし、ReachPlanService は、キャンペーンを実施するための特定のお客様アカウントを設定する前に行われる可能性のある動画プランニング アクティビティを対象としています。
内部ツール
組織内で内部使用するツールを構築する場合は、次のオプションを検討してください。
- クライアント アカウントに直接アクセスできないプランナー: クライアントの Google 広告アカウントにアクセスできないプランナーの場合は、クライアント センター（MCC）アカウントにアクセスできるユーザーのシングル ユーザー認証フローを使用して OAuth 認証情報を生成します。次に、ツールを使用してチームごとに Google 広告アカウントを作成または取得し、クライアント センター（MCC）アカウントにリンクします。
ReachPlanServiceにリクエストを行う場合は、ユーザーのチームに対応する顧客 ID を指定します。 - クライアント アカウントにアクセスできるプランナー: クライアントのアカウントを管理する Google 広告 MCC アカウントにプランナーがアクセスできる場合は、マルチユーザー認証フローを実装して、プランナーの OAuth 認証情報を使用できるようにします。その後、お客様のプランに対応するお客様 ID を渡すことができます。
外部ツール
サードパーティまたは外部ユーザー向けのツールを構築する場合は、次のオプションをおすすめします。
- クライアント アカウントごと: MCC アカウントにアクセスできるユーザーのシングル ユーザー認証フローを使用して OAuth 認証情報を生成します。外部クライアントごとに Google 広告アカウントを作成し、MCC アカウントにリンクします。プランを生成する際に、クライアントの対応するお客様 ID を提供するようにツールを設定します。
- ユーザーが許可したアクセス: マルチユーザー認証フローを使用して、ユーザーがツールにアカウントへのアクセスを許可できるようにします。ユーザーが権限を付与したら、
CustomerServiceを使用して、ユーザーがアクセスできる Google 広告アカウントのリストを取得します。
API を統合する前に、システム要件に基づいて上記のアプローチのいずれかを選択し、いくつかのテスト顧客 ID を特定します。不明な場合は、リンクされたアカウントで単一ユーザー認証フローから始めます。
次のステップ
詳しくは、メディア プランを指定する方法をご覧ください。