Google API Console プロジェクトの作成と構成の手順は、アプリケーションで構築する OAuth 2.0 認証シナリオのタイプによって異なります。構築する認可シナリオを選択します。このガイドは、選択内容に基づいてカスタマイズされます。
OAuth 2.0 認証情報を作成し、アプリで Google Ads API を有効にするには、Google API Console プロジェクトが必要です。
認証情報は、Google サーバーによる Google 広告ユーザーの認証と承認に必要です。これらの認証情報を使用すると、API 呼び出しで使用する OAuth トークンを生成できます。
Google API Console プロジェクトを選択または作成する
手順に沿ってプロジェクトを作成します。プロジェクトに対する課金を有効にすることは省略可能です。課金が有効になっている場合は、新しいプロジェクトの請求先アカウントを選択します。Google Ads API の使用には料金はかかりませんが、Cloud プロジェクトには総数の割り当てがあります。
プロジェクトで Google Ads API を有効にする
プロジェクトで Google Ads API を有効にするには、次の手順に沿って操作します。
Google API Console で API ライブラリを開きます。プロンプトが表示されたら、プロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用できるすべての API がプロダクト ファミリーと人気度によって分類され、表示されます。
リストに表示されない場合は、検索を使用して Google Ads API を見つけます。
API を選択し、[有効にする] ボタンをクリックします。
API アクセスを申請する
次に、Google Ads API の概要ページをご覧ください。ページに現在の API アクセスレベルが表示されます。現在の API アクセスレベルが [テストアクセス] の場合は、[次のアクセスレベルを申請] セクションを開きます。手順に沿って、探索ユーザー アクセスレベルを申請します。
お申し込みが完了すると、Google が自動的に審査を行い、ほとんどの場合、エクスプローラ アクセスにアップグレードされます。
OAuth 同意画面を構成する
認可に OAuth 2.0 を使用する場合、Google はユーザーに同意画面を表示します。この画面には、プロジェクトの概要、ポリシー、リクエストされたアクセスの認可スコープが含まれます。アプリの OAuth 同意画面を構成することで、ユーザーとアプリの審査担当者に表示されるものを定義し、後でアプリを公開できるようにアプリを登録します。
手順に沿って、アプリケーションの OAuth 同意画面を構成し、OAuth スコープとして https://www.googleapis.com/auth/adwords を追加します。
ユーザータイプと公開ステータスに関する重要な考慮事項
OAuth 同意画面を構成する際は、[ユーザータイプ] と [公開ステータス] の設定に注意してください。
- ユーザータイプ: アプリを組織内のユーザーのみに制限するか（「内部」）、すべての Google ユーザーが利用できるようにするか（「外部」）を定義します。[内部] は、プロジェクトが Google Workspace 組織の一部である場合にのみ選択できます。
- 公開ステータス: アプリが「テスト」モード（追加した特定のテストユーザーのみが利用可能）か「本番環境」（ユーザータイプで定義されたユーザーが利用可能。Google によるアプリの確認が必要になる場合がある）かを決定します。
アプリケーションに最適な選択を行うには、Google Cloud の公式サポート ドキュメントで、これらの設定の詳細な説明と影響を確認してください。
これらの設定を理解することは、アプリが対象ユーザーに確実にアクセスできるようにするために非常に重要です。
クライアント ID とクライアント シークレットを作成する
クライアント ID とクライアント シークレットがすでに生成されている既存の Google API Console プロジェクトを使用している場合は、この手順をスキップできます。それ以外の場合は、手順に沿ってクライアント ID とクライアント シークレットを作成します。アプリケーションの種類として [デスクトップ アプリ] または [ウェブ アプリケーション] を選択できます。OAuth 2.0 クライアントを作成したら、まず [OAuth クライアントをダウンロード] アイコンをクリックし、次の画面で [JSON をダウンロード] ボタンをクリックして、クライアントの JSON ファイルをダウンロードします。