〜 プロジェクト作成から、OAuth 2.0 Playground で検索データを取得するまで 〜

対象:Google Cloud のプロジェクトをまだ持っていない人
ゴール:自分のサイトの Search Console データ(表示回数・クリック数・検索クエリなど)を API で取得できる状態にする
前提:Googleアカウントを持っていること/対象サイトが Search Console に登録済みであること

全体の流れ

  1. Google Cloud プロジェクトを作成する
  2. Search Console API を有効化する
  3. OAuth 同意画面を設定する(Google Auth Platform)
  4. OAuth クライアントを作成し、リダイレクトURIを登録する
  5. 認証情報(JSON)をダウンロードして保管する
  6. OAuth 2.0 Playground に自分の認証情報を設定する
  7. 認可してトークンを取得する
  8. API を呼び出してデータを取得する

手順1:プロジェクトを作成する

  1. ブラウザで Google Cloud Console(console.cloud.google.com)を開き、Googleアカウントでログインする
  2. 画面上部のプロジェクト名が表示されたボタン(プロジェクト選択)をクリックし、開いた画面の右上「新しいプロジェクト」を押す
プロジェクト選択画面
図1 プロジェクト選択画面(右上が「新しいプロジェクト」)
  1. 「プロジェクト名」を入力する(例:search-console-api)。初期状態では「My Project ○○○」のような名前が入っているので書き換える
  2. 「プロジェクトID」は自動で決まり、後から変更できない。そのままでよい
  3. 「親リソース」は「組織なし」のままにする
  4. 「作成」をクリックし、作成されたプロジェクトに切り替わっていることを確認する
新しいプロジェクト画面
図2 新しいプロジェクト画面
アカウントによっては「残りのプロジェクト数」の注意書きが出るが、そのまま進めて問題ない。作成後は、コンソールのトップで「選択中のプロジェクト」に自分のプロジェクト名が出ていればOK。
プロジェクト選択中の表示
図3 プロジェクトが選択された状態(番号・IDはマスク済み)

手順2:Search Console API を有効化する

  1. 左メニュー「APIとサービス」→「ライブラリ」を開く
  2. 検索欄に「google search console api」と入力すると「Google Search Console API」が1件だけ表示されるので、それを選ぶ
APIライブラリ検索結果
図4 APIライブラリの検索結果
  1. 詳細画面で「有効にする」をクリックする
APIを有効にする
図5 「有効にする」ボタン
すでに有効化済みのプロジェクトでは、ボタンの代わりに「管理」と「API が有効です」と表示される。その場合はこの手順は不要。
有効化済みの表示
図6 有効化済みの場合の表示
この有効化を忘れると、後のAPI呼び出しでエラー(403)になる。

手順3:OAuth 同意画面を設定する(Google Auth Platform)

現在のコンソールでは、OAuth同意画面は「Google Auth Platform」に移行している。左メニューは「概要/ブランディング/対象/クライアント/データアクセス/検証センター/設定」という構成。

  1. 「APIとサービス」→「OAuth同意画面」を開く(Google Auth Platform の「概要」画面になる)
  2. 未構成のプロジェクトでは「Google Auth Platform はまだ構成されていません」と表示されるので、「開始」を押す
Google Auth Platform開始画面
図7 Google Auth Platform の開始画面
  1. ウィザードは4ステップ(①アプリ情報 → ②対象 → ③連絡先情報 → ④終了):
    • ①アプリ情報:「アプリ名」(任意。例:Search Console 取得用)と「ユーザーサポートメール」(プルダウンから自分のメールアドレスを選ぶ)を入力して「次へ」
ウィザード アプリ情報
図8 ウィザード①アプリ情報
  • ②対象:「外部」を選んで「次へ」。「内部」は組織内のユーザー専用なので、個人利用では選ばない
ウィザード 対象
図9 ウィザード②対象(「外部」を選ぶ)
  1. ③連絡先情報:メールアドレスを入力して「次へ」
  2. ④終了:内容を確認して「作成」
  3. 作成後、左メニュー「対象」を開き、テストユーザーに自分のGoogleアカウントのメールアドレスを追加する
「外部」で作るとアプリはテストモードで始まり、使えるのはテストユーザーに追加したユーザーだけになる(自分のためだけに使うならこれで十分)。テストユーザーの追加がないと、手順7の認可でエラーになる。

手順4:OAuth クライアントを作成する

  1. Google Auth Platform の左メニュー「クライアント」を開き、「+ クライアントを作成」を押す
クライアント一覧
図10 クライアント一覧
  1. 「OAuth クライアント ID の作成」画面で、「アプリケーションの種類」のプルダウンから「ウェブアプリケーション」を選ぶ
クライアント作成
図11 クライアント作成・種類の選択
  1. 名前を入力する(任意。例:Playground用)
  2. 「承認済みのリダイレクト URI」の「+ URI を追加」を押し、次のURLを正確に入力する:
    https://developers.google.com/oauthplayground
  3. 「作成」をクリックする。作成後はクライアントの詳細画面が開き、名前・リダイレクトURI・クライアントID・クライアントシークレットの欄が並ぶ
クライアント詳細
図12 クライアント詳細(リダイレクトURI入力済みの状態)
リダイレクトURIが1文字でも違うと、後の認可で redirect_uri_mismatch エラーになる。
画面にも注記が出るが、設定が有効になるまで5分から数時間かかることがある。作成直後に認可でエラーが出たら、少し待ってから試すこと。また、6か月間使われていないOAuthクライアントは削除対象になる、という注意も画面に表示される。作りっぱなしに注意。

手順5:認証情報(JSON)をダウンロードして保管する

  1. クライアントの詳細画面で、右側「Additional information」や「クライアント シークレット」欄にあるダウンロードアイコンから、JSONファイルをダウンロードする(図12)
  2. このJSONにはクライアントシークレット(パスワード相当)が含まれる:
    • チャットやメール本文に貼らない
    • 公開リポジトリやブログに載せない
    • 保管場所を決めて、他人と共有しない

手順6:OAuth 2.0 Playground に自分の認証情報を設定する

  1. OAuth 2.0 Playground(developers.google.com/oauthplayground)を開く
Playgroundトップ
図13 OAuth 2.0 Playground のトップ画面
  1. 右上の歯車アイコン「OAuth 2.0 configuration」を開く
  2. 「Use your own OAuth credentials」にチェックを入れる(チェックすると入力欄が現れる)
  3. OAuth Client ID と OAuth Client secret に、手順5のJSONに書かれた値を入力する
  4. 「Close」で閉じる
Playground設定パネル
図14 Playground の設定パネル(値は空欄の状態)
IDとシークレットは Google のページ上でのみ入力する。誰にも渡さないこと。

手順7:認可してトークンを取得する

  1. 左側 Step 1 の一覧から「Google Search Console API v1」を展開し、https://www.googleapis.com/auth/webmasters.readonly を選択する(見つからない場合は、下部の「Input your own scopes」欄にこのURLを直接入力してもよい)
スコープ選択
図15 スコープの選択
一覧の表記は「v1」だが、これはPlayground側の分類名。手順8で使うAPIのURLは v3 のままでよい。
  1. 「Authorize APIs」をクリックする
  2. Googleのログイン・同意画面が出るので、対象サイトを持つGoogleアカウントでログインし、許可する
  3. Step 2 に進み、「Exchange authorization code for tokens」をクリックする
トークン交換
図16 Step 2 トークン交換
  1. アクセストークンが発行される
「このアプリは確認されていません」と出た場合は「詳細」→「(アプリ名)に移動」で進む(自分で作ったアプリなので問題ない)。アクセストークンの有効期限は約1時間。切れたら手順7の4(トークン交換)からやり直す。

手順8:API を呼び出す

8-1. まずサイト一覧で疎通確認

  1. Step 3「Configure request to API」を開く
  2. HTTP Method:GET
  3. Request URI に次を入力し、「Send the request」:
    https://www.googleapis.com/webmasters/v3/sites
  4. 右側に HTTP 200 とサイト一覧のJSONが返れば成功
Step 3 リクエスト設定
図17 Step 3 リクエストの設定

8-2. 検索データを取得する(ページ別)

  1. HTTP Method:POST
  2. Request URI(サイトURLはURLエンコードする。例:https://example.com/ の場合):
    https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fexample.com%2F/searchAnalytics/query
  3. 「Enter request body」に次を入力する(日付は取得したい期間に変える):
{"startDate": "2026-10-16", "endDate": "2026-11-12", "dimensions": ["page"], "rowLimit": 25}
  1. 「Send the request」で、ページごとの表示回数・クリック数・CTR・平均順位が返る
クエリ別に見る場合は dimensions を [“query”, “page”] に変える。

トラブルシューティング

症状 原因と対処
redirect_uri_mismatch 手順4のリダイレクトURIが不一致。https://developers.google.com/oauthplayground が正確に登録されているか確認
invalid_client クライアントID/シークレットの入力ミス。JSONからコピーし直す
403(API呼び出し時) 手順2のAPI有効化漏れ、または対象サイトの権限がないアカウントで認可した
トークンが切れた(401) 約1時間の期限切れ。手順7のトークン交換からやり直す
「このアプリは確認されていません」 自分で作成したアプリの場合は「詳細」から進んでよい
作成直後に認可エラー 設定の反映に5分〜数時間かかることがある。少し待って再試行

セキュリティ上の注意

  • クライアントシークレットとアクセストークンはパスワードと同じ扱いにする
  • 認証情報JSONは公開場所に置かない
  • 使わなくなったOAuthクライアントはコンソールから削除する

本マニュアルの画面は 2026年11月時点の実際の画面で確認したものです。Google の画面は変更されることがあります。