対象:Google Cloud のプロジェクトをまだ持っていない人
ゴール:自分のサイトの Search Console データ(表示回数・クリック数・検索クエリなど)を API で取得できる状態にする
前提:Googleアカウントを持っていること/対象サイトが Search Console に登録済みであること
全体の流れ
- Google Cloud プロジェクトを作成する
- Search Console API を有効化する
- OAuth 同意画面を設定する(Google Auth Platform)
- OAuth クライアントを作成し、リダイレクトURIを登録する
- 認証情報(JSON)をダウンロードして保管する
- OAuth 2.0 Playground に自分の認証情報を設定する
- 認可してトークンを取得する
- API を呼び出してデータを取得する
手順1:プロジェクトを作成する
- ブラウザで Google Cloud Console(console.cloud.google.com)を開き、Googleアカウントでログインする
- 画面上部のプロジェクト名が表示されたボタン(プロジェクト選択)をクリックし、開いた画面の右上「新しいプロジェクト」を押す
- 「プロジェクト名」を入力する(例:search-console-api)。初期状態では「My Project ○○○」のような名前が入っているので書き換える
- 「プロジェクトID」は自動で決まり、後から変更できない。そのままでよい
- 「親リソース」は「組織なし」のままにする
- 「作成」をクリックし、作成されたプロジェクトに切り替わっていることを確認する
アカウントによっては「残りのプロジェクト数」の注意書きが出るが、そのまま進めて問題ない。作成後は、コンソールのトップで「選択中のプロジェクト」に自分のプロジェクト名が出ていればOK。
手順2:Search Console API を有効化する
- 左メニュー「APIとサービス」→「ライブラリ」を開く
- 検索欄に「google search console api」と入力すると「Google Search Console API」が1件だけ表示されるので、それを選ぶ
- 詳細画面で「有効にする」をクリックする
すでに有効化済みのプロジェクトでは、ボタンの代わりに「管理」と「API が有効です」と表示される。その場合はこの手順は不要。
この有効化を忘れると、後のAPI呼び出しでエラー(403)になる。
手順3:OAuth 同意画面を設定する(Google Auth Platform)
現在のコンソールでは、OAuth同意画面は「Google Auth Platform」に移行している。左メニューは「概要/ブランディング/対象/クライアント/データアクセス/検証センター/設定」という構成。
- 「APIとサービス」→「OAuth同意画面」を開く(Google Auth Platform の「概要」画面になる)
- 未構成のプロジェクトでは「Google Auth Platform はまだ構成されていません」と表示されるので、「開始」を押す
- ウィザードは4ステップ(①アプリ情報 → ②対象 → ③連絡先情報 → ④終了):
- ①アプリ情報:「アプリ名」(任意。例:Search Console 取得用)と「ユーザーサポートメール」(プルダウンから自分のメールアドレスを選ぶ)を入力して「次へ」
- ②対象:「外部」を選んで「次へ」。「内部」は組織内のユーザー専用なので、個人利用では選ばない
- ③連絡先情報:メールアドレスを入力して「次へ」
- ④終了:内容を確認して「作成」
- 作成後、左メニュー「対象」を開き、テストユーザーに自分のGoogleアカウントのメールアドレスを追加する
「外部」で作るとアプリはテストモードで始まり、使えるのはテストユーザーに追加したユーザーだけになる(自分のためだけに使うならこれで十分)。テストユーザーの追加がないと、手順7の認可でエラーになる。
手順4:OAuth クライアントを作成する
- Google Auth Platform の左メニュー「クライアント」を開き、「+ クライアントを作成」を押す
- 「OAuth クライアント ID の作成」画面で、「アプリケーションの種類」のプルダウンから「ウェブアプリケーション」を選ぶ
- 名前を入力する(任意。例:Playground用)
- 「承認済みのリダイレクト URI」の「+ URI を追加」を押し、次のURLを正確に入力する:
https://developers.google.com/oauthplayground - 「作成」をクリックする。作成後はクライアントの詳細画面が開き、名前・リダイレクトURI・クライアントID・クライアントシークレットの欄が並ぶ
リダイレクトURIが1文字でも違うと、後の認可で redirect_uri_mismatch エラーになる。
画面にも注記が出るが、設定が有効になるまで5分から数時間かかることがある。作成直後に認可でエラーが出たら、少し待ってから試すこと。また、6か月間使われていないOAuthクライアントは削除対象になる、という注意も画面に表示される。作りっぱなしに注意。
手順5:認証情報(JSON)をダウンロードして保管する
- クライアントの詳細画面で、右側「Additional information」や「クライアント シークレット」欄にあるダウンロードアイコンから、JSONファイルをダウンロードする(図12)
- このJSONにはクライアントシークレット(パスワード相当)が含まれる:
- チャットやメール本文に貼らない
- 公開リポジトリやブログに載せない
- 保管場所を決めて、他人と共有しない
手順6:OAuth 2.0 Playground に自分の認証情報を設定する
- OAuth 2.0 Playground(developers.google.com/oauthplayground)を開く
- 右上の歯車アイコン「OAuth 2.0 configuration」を開く
- 「Use your own OAuth credentials」にチェックを入れる(チェックすると入力欄が現れる)
- OAuth Client ID と OAuth Client secret に、手順5のJSONに書かれた値を入力する
- 「Close」で閉じる
IDとシークレットは Google のページ上でのみ入力する。誰にも渡さないこと。
手順7:認可してトークンを取得する
- 左側 Step 1 の一覧から「Google Search Console API v1」を展開し、
https://www.googleapis.com/auth/webmasters.readonlyを選択する(見つからない場合は、下部の「Input your own scopes」欄にこのURLを直接入力してもよい)
一覧の表記は「v1」だが、これはPlayground側の分類名。手順8で使うAPIのURLは v3 のままでよい。
- 「Authorize APIs」をクリックする
- Googleのログイン・同意画面が出るので、対象サイトを持つGoogleアカウントでログインし、許可する
- Step 2 に進み、「Exchange authorization code for tokens」をクリックする
- アクセストークンが発行される
「このアプリは確認されていません」と出た場合は「詳細」→「(アプリ名)に移動」で進む(自分で作ったアプリなので問題ない)。アクセストークンの有効期限は約1時間。切れたら手順7の4(トークン交換)からやり直す。
手順8:API を呼び出す
8-1. まずサイト一覧で疎通確認
- Step 3「Configure request to API」を開く
- HTTP Method:GET
- Request URI に次を入力し、「Send the request」:
https://www.googleapis.com/webmasters/v3/sites - 右側に HTTP 200 とサイト一覧のJSONが返れば成功
8-2. 検索データを取得する(ページ別)
- HTTP Method:POST
- Request URI(サイトURLはURLエンコードする。例:https://example.com/ の場合):
https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fexample.com%2F/searchAnalytics/query - 「Enter request body」に次を入力する(日付は取得したい期間に変える):
{"startDate": "2026-10-16", "endDate": "2026-11-12", "dimensions": ["page"], "rowLimit": 25}
- 「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クライアントはコンソールから削除する
