Google API Console プロジェクトの作成と構成の方法は、アプリケーションの OAuth 2.0 認証シナリオによって異なります。このガイドをカスタマイズするには、認可シナリオを選択します。
OAuth 2.0 認証情報を作成し、アプリで Google Ads API を有効にするには、Google API Console プロジェクトが必要です。
これらの認証情報は、Google サーバーでアプリまたは Google 広告ユーザーを認証して承認し、API への呼び出しで使用する OAuth トークンを生成できるようにします。
Google API Console プロジェクトを選択または作成する
新しいプロジェクトを設定するには、Google API Console プロジェクトを作成するガイドに沿って操作します。プロジェクトに対する課金を有効にすることは任意です。課金が有効になっている場合は、新しいプロジェクトの請求先アカウントを選択します。Google Ads API の使用に料金はかかりませんが、Cloud プロジェクトには標準のプロジェクト割り当て上限が適用されます。
プロジェクトで Google Ads API を有効にする
プロジェクトで Google Ads API を有効にする手順は次のとおりです。
Google API Console で API ライブラリを開きます。プロンプトが表示されたら、プロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用できるすべての API がプロダクト ファミリーと人気度によって分類され、表示されます。
リストに Google Ads API が表示されていない場合は、検索して見つけます。
[Google Ads 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 とクライアント シークレットを作成します。アプリケーションの種類として [デスクトップ アプリ] または [ウェブ アプリケーション] のいずれかを選択できます。OAuth 2.0 クライアントを作成したら、確認ダイアログの [JSON をダウンロード] ボタンをクリックして、クライアントの JSON ファイルをダウンロードします。