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 の使用に料金はかかりませんが、クラウド プロジェクトには標準のプロジェクト割り当て制限が適用されます。
プロジェクトで 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 同意
画面を構成し、
https://www.googleapis.com/auth/adwords を OAuth スコープとして追加します。
ユーザータイプと公開ステータスに関する重要な考慮事項
OAuth 同意画面を構成する際は、[ユーザータイプ] と [公開ステータス] の設定に注意してください。
- ユーザータイプ: アプリを組織内のユーザーのみに制限する（[内部]）か、すべての Google ユーザーが利用できるようにする（[外部]）かを定義します。 [内部] は、プロジェクトが Google Workspace 組織の一部である場合にのみ使用できます。
- 公開ステータス: アプリが [テスト] モード （追加した特定のテストユーザーのみに制限）か、[本番環境]（ [ユーザータイプ] で定義されたユーザーが利用可能。Google によるアプリの確認が必要になる場合があります）かを決定します。
アプリケーションに最適な選択を行うには、Google Cloud の公式サポート ドキュメントで、これらの設定の詳細な説明と影響を確認してください。
これらの設定を理解することは、アプリケーションを対象ユーザーが利用できるようにするために不可欠です。
クライアント ID とクライアント シークレットを作成する
クライアント ID とクライアント シークレットを作成します。アプリケーションの種類として [デスクトップ アプリ] または [ウェブ アプリケーション] を選択できます。OAuth 2.0 クライアントを作成したら、確認ダイアログの [JSON をダウンロード] ボタンをクリックして、クライアントの JSON ファイルをダウンロードします。