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 アクセスレベルが [テスト] の場合は、[アクセスレベルをアップグレード] セクションを開きます。手順に沿って、Explorer アクセスレベルを申請します。
申請が完了すると、Google は申請内容を自動システムによる審査し、ほとんどの場合、エクスプローラ アクセスにアップグレードします。
OAuth 同意画面を構成する
認可に OAuth 2.0 を使用する場合、ユーザーには、プロジェクトとそのポリシーの概要、リクエストされたアクセスの認可スコープなどを含む同意画面が表示されます。アプリの OAuth 同意画面を構成することで、ユーザーとアプリの審査担当者に表示される内容を定義し、後でアプリを公開できるようにアプリを登録します。
アプリケーションの OAuth 同意画面を構成し、https://www.googleapis.com/auth/adwords を OAuth スコープとして追加します。
ユーザータイプと公開ステータスに関する重要な考慮事項
OAuth 同意画面を構成するときは、[ユーザータイプ] と [公開ステータス] の設定に注意してください。
- ユーザータイプ: アプリを組織内のユーザーに限定するか（内部）、すべての Google ユーザーが利用できるようにするか（外部）を定義します。[内部] は、プロジェクトが Google Workspace 組織の一部である場合にのみ使用できます。
- 公開ステータス: アプリがテストモード（追加した特定のテストユーザーに限定）か、本番環境（ユーザータイプで定義されたオーディエンスが利用可能。Google によるアプリの確認が必要になる場合があります）かを決定します。
アプリケーションに最適な選択を行うには、Google Cloud の公式サポート ドキュメントで、これらの設定の詳細な説明と影響を確認してください。
これらの設定を理解することは、対象ユーザーがアプリケーションにアクセスできるようにするために重要です。
クライアント ID とクライアント シークレットを作成する
クライアント ID とクライアント シークレットを作成します。アプリケーションの種類として、[デスクトップ アプリ] または [ウェブ アプリケーション] のいずれかを選択できます。OAuth 2.0 クライアントを作成したら、確認ダイアログの [JSON をダウンロード] ボタンをクリックして、クライアントの JSON ファイルをダウンロードします。