ReachPlanService へのリクエストでは、OAuth
認証情報と、OAuth 認証情報でアクセスできるお客様 ID を指定する必要があります。また、OAuth 認証情報に関連付けられた Google Cloud プロジェクトが、このサービスの使用について承認されている必要があります。
このガイドでは、
ReachPlanService に固有の認証の詳細について説明します。まだ行っていない場合は、まず
スタートガイドの手順を完了してから、このガイドに戻ってください。
OAuth 認証情報
スタートガイドに記載されているガイダンスに加えて、次の点に留意してください。
- Google Cloud プロジェクト番号が他の Google Ads API サービスでの使用についてすでに承認されている場合でも、
ReachPlanServiceに接続するには、適切な許可リスト に Google Cloud プロジェクト番号を追加する必要があります。詳しくは、 利用資格要件をご覧ください。 - Google Ads API に接続するには、Google Ads API 利用規約に同意する必要があります。
- OAuth 更新トークンを所有するユーザーによって、クエリを
実行できるお客様 ID が決まります
ReachPlanService。これは統合に影響します。詳細については、以降のセクションで説明します。
お客様 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 を特定します。不明な場合は、リンクされたアカウントでシングルユーザー認証フロー から始めます。
次のステップ
メディアプランを指定する方法を確認する。