OAuth 2.0 認証情報の作成、ユーザーの同意画面の設定、アプリでの Google Ads API の有効化を行うには、Google API Console プロジェクトが必要です。
この認証情報は、Google のサーバーから Google 広告ユーザーの認証と認可を行うために必要です。これらの認証情報により、API の呼び出しで使用する OAuth トークンを生成できます。
Google API Console プロジェクトを選択または作成する
すでに Google API Console プロジェクトがあり、そのプロジェクトを使用して認証情報を作成する場合は、クライアント ID とクライアント シークレットを作成するに進んでください。
プロジェクトを作成するには、次の操作を行います。
- Google API Console に移動します。
- [プロジェクトを作成] をクリックします。
- 名前を入力するか、生成された候補を承認します
- 残りの項目を確認または編集してください
- [作成] をクリックします。
課金を有効にしている場合は、新しいプロジェクトの請求先アカウントを選択します。Google Ads API の利用は無料ですが、Cloud プロジェクトの合計数には割り当てがあります。
OAuth 同意画面を構成する
既存の Google API Console プロジェクトを使用していて、以前に OAuth 同意画面を設定したことがある場合は、この手順をスキップし、代わりに Google Ads API OAuth 2.0 スコープを追加して同意画面を変更できます。
認可に OAuth 2.0 を使用すると、プロジェクトの概要、ポリシー、リクエストされたアクセスの承認スコープを含む同意画面が表示されます。アプリの OAuth 同意画面を構成すると、ユーザーやアプリの審査担当者に表示される内容が定義され、後で公開できるようにアプリが登録されます。
新しい OAuth 同意画面を構成する
- [同意画面] ページを開き、ページの上部にあるプルダウン メニューからプロジェクトを選択します。
- [ユーザーの種類] を選択し、[作成] をクリックします。
- 同意画面フォームに入力します。これは必要に応じて後で編集できます。 完了したら、[保存して次へ] をクリックします。
- 次のページで、[スコープを追加または削除] をクリックします。
- 下にスクロールして、[手動でスコープを追加] のフィールドに次のように入力します。
https://www.googleapis.com/auth/adwords
- [表に追加] をクリックします。
- プロジェクトに必要な他のスコープを追加して、[更新] をクリックします。
- [保存して次へ] をクリックします。
- プロジェクトをすぐに公開しない場合は、テストに使用する各ユーザー アカウントのメールアドレスを追加して、[保存して次へ] をクリックします。
- 概要ページを確認し、[ダッシュボードに戻る] をクリックします。
既存の OAuth 同意画面を構成する
- [同意画面] ページを開き、ページの上部にあるプルダウン メニューからプロジェクトを選択します。
- [アプリを編集] をクリックします。
- [OAuth 同意画面] フォームで、[保存して次へ] をクリックします。
- 次のページで、[スコープを追加または削除] をクリックします。
- 下にスクロールして、[手動でスコープを追加] のフィールドに次のように入力します。
https://www.googleapis.com/auth/adwords
- [表に追加] をクリックします。
- [保存して次へ] をクリックします。
- [テストユーザー] フォームで、[保存して次へ] をクリックします。
- 概要ページを確認し、[ダッシュボードに戻る] をクリックします。
クライアント ID とクライアント シークレットを作成する
クライアント ID とシークレットが生成されている既存の Google API Console プロジェクトを使用している場合は、この手順をスキップできます。
アプリの種類を決定したら、以下の手順に沿って OAuth 2.0 クライアント ID とクライアント シークレットを生成します。
[認証情報] ページを開きます。以前に作成したプロジェクトを選択するか、新しいプロジェクトを作成します。
[認証情報] 画面で [認証情報を作成] をクリックし、[OAuth クライアント ID] を選択します。
このプロジェクトで OAuth 同意画面をまだ構成していない場合は、[同意画面を構成] をクリックします。
ユーザータイプを選択し、[作成] をクリックします。
最初のフォームに入力します。これは、必要に応じて後で編集できます。完了したら [保存] をクリックします。
[認証情報] > [認証情報を作成] > [OAuth クライアント ID] に戻って続行します。
ユースケースに応じて、アプリの種類として [デスクトップ アプリ] または [ウェブ アプリケーション] を選択します。このガイドでは、アプリの種類として [デスクトップ アプリ] を使用します。
アプリの名前を入力して、[Create] をクリックします。
後でクライアント ライブラリを構成するために、確認ページでクライアント ID とクライアント シークレットをクリップボードにコピーします。また、JSON 形式の認証情報を
credentials.json
という名前のファイルにダウンロードします。
プロジェクトで Google Ads API を有効にする
プロジェクトで Google Ads API を有効にする手順は次のとおりです。
Google API コンソールで API ライブラリを開きます。プロンプトが表示されたら、プロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用できるすべての API がプロダクト ファミリーと人気度によって分類され、表示されます。
リストに表示されない場合は、検索を使用して Google Ads API を見つけます。
API を選択し、[有効にする] ボタンをクリックします。