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 同意画面を設定する
- [同意画面] ページを開き、ページの上部にあるプルダウン メニューでプロジェクトを選択します。
- [EDIT APP] をクリックします。
- 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 を選択し、[有効にする] ボタンをクリックします。