Google の OAuth2 サーバーにアクセスするための認証情報は、Google 広告ユーザーを認証したり承認したりするために必要です。この認証情報により Google に対してアプリを識別し、Google 広告ユーザーを管理するための OAuth トークンを生成できます。Google OAuth2 認証情報へのアクセスは、Google API Console で管理されています。
Cloud プロジェクトのベスト プラクティスに関するこちらの動画をご覧ください
Google OAuth の確認
Google Ads API スコープの認証情報を取得するために使用する Google Cloud アプリでは、未確認の UI 画面を避けるため、Google OAuth 検証を行う必要があります。この場合のアプリは、Google Cloud 内で一意の OAuth 2.0 クライアント ID として定義されます。
この検証は独立したプロセスであり、開発者トークンの承認プロセスの一環として行われるレビューに加えて、Google Ads API のスコープがプライベートなスコープであるため必要です。
Google による確認は無料で、通常 3 ～ 5 営業日以内に完了します。このポリシーはすべてのアプリに適用されます。
業務に支障が生じることのないよう、できるだけ早く Google OAuth 検証プロセスを実施することをおすすめします。
プロジェクトを作成する
Google API Console に移動します。[プロジェクトを作成] をクリックし、名前を入力して [作成] をクリックします。
プロジェクトで Google Ads API を有効にする
プロジェクトで Google Ads API を有効にする手順は次のとおりです。
Google API コンソールで API ライブラリを開きます。プロンプトが表示されたら、プロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用できるすべての API がプロダクト ファミリーと人気度によって分類され、表示されます。
リストに表示されない場合は、検索を使用して Google Ads API を見つけます。
API を選択し、[有効にする] ボタンをクリックします。
ユーザータイプと公開ステータスを選択する
API を有効にしたら、プロジェクトのユーザータイプと公開ステータスを指定する必要があります。次の表に、これらの設定の各組み合わせの主な属性と制限事項を示します。詳細については、Google Cloud Platform のドキュメントをご覧ください。
| ユーザーの種類 | 公開ステータス | 制限事項 |
|---|---|---|
| 社内向け | テスト |
|
| 外側 | テスト |
|
| 社内向け | 本番環境 |
|
| 外側 | 本番環境 |
|
Google OAuth 検証を完了しないと、プロジェクトのユーザータイプまたは公開ステータスに関係なく、次のようになります。
承認プロセス中に、ユーザーには未確認の UI 画面が表示されます。
承認できるユーザーは 100 人までです。
OAuth 同意画面を構成する
同意画面のページを開き、ページの上部にあるプルダウン メニューでプロジェクトを選択します。
[User Type] を選択して、[CREATE] をクリックします。
同意画面のフォームに記入します。後で必要に応じて編集できます。完了したら [保存して次へ] をクリックします。
次のページで [追加または削除] をクリックします。
下にスクロールして、[手動でスコープを追加] のフィールドに次のように入力します。
https://www.googleapis.com/auth/adwords[テーブルに追加] をクリックします。
プロジェクトでリクエストするその他のスコープを追加し、[更新] をクリックします。
[保存して次へ] をクリックします。
プロジェクトをすぐに公開する予定がない場合は、テストに使用する各ユーザーのメールアドレスを入力し、[保存して次へ] をクリックします。
概要ページを確認し、[ダッシュボードに戻る] をクリックします。
アプリケーションと承認プロセスをテストしたら、ダッシュボードに戻って [アプリを公開] をクリックし、[公開ステータス] を [テスト] から [本番環境] に変更します。
アプリの種類を選択してください
Google Ads API には、デスクトップとウェブの 2 種類のアプリ オプションがあります。次の表を参考にして、ビルドするアプリに最適なタイプを決定してください。
| アプリケーションのタイプ | 適しているケース |
|---|---|
| デスクトップ アプリ |
|
| ウェブアプリ |
|
詳細については、デスクトップ アプリまたはウェブアプリに関する Google Identity Platform OAuth ドキュメントをご覧ください。
クライアント ID とクライアント シークレットを作成する
アプリケーションのタイプが決まったら、次の手順に沿って OAuth2 クライアント ID とクライアント シークレットを生成します。
[認証情報] ページを開きます。以前に作成したプロジェクトを選択するか、新しいプロジェクトを作成します。
認証情報画面で [認証情報を作成] をクリックし、[OAuth クライアント ID] を選択します。
このプロジェクトで OAuth 同意画面を以前に構成していない場合は、ここで構成できます。[同意画面を構成] をクリックします。
ユーザータイプを選択して [作成] をクリックします。
最初のフォームに記入します。後で必要に応じて編集できます。完了したら、[保存] をクリックします。
[Credentials] > [CREATE CREDENTIALS] > [OAuth client ID] に戻り、続行します。
ユースケースに応じて、アプリタイプとして [デスクトップ アプリ] または [ウェブ アプリケーション] を選択します。
名前を付けて [作成] をクリックします。
クライアント タイプがウェブ アプリケーションの場合は、承認済みのリダイレクト URI を少なくとも 1 つ追加します。
クライアント ライブラリの例のデフォルト構成と互換性のあるローカルテストには、
http://127.0.0.1を使用します。デスクトップ アプリ クライアントの場合は、引き続きループバック IP リダイレクトを使用しますが、URI は Cloud Console で明示的に構成されません。
確認ページでクライアント ID とクライアント シークレットをクリップボードにコピーします。これらは、クライアント ライブラリを構成する際に必要になります。後で認証情報ページに戻ってこれらの詳細を取得することもできます。
