URL Inspection API×GASでインデックス状況を自動一括チェックするスプレッドシート

複数URLのインデックス状況をまとめてチェックするなら、GoogleのURL Inspection APIが便利です。

URL Inspection APIは、Search Consoleの「URL検査」をプログラムから実行できるGoogle公式のAPI。 インデックスの有無や最終クロール日時、Googleが選んだ正規URLなど、全部で11項目を一括取得できます。

この記事では、Inspection APIを使った無料のチェックツール（スプレッドシート）を配布しています。 自動実行を設定しておけば毎日チェックが走るので、インデックス漏れにも早めに気づけるようになります。

チームでの共有もしやすいため、サイト移行後のチェックや定期的なインデックス監視を効率化したい方は、ぜひご活用ください。

Inspection APIのリクエスト制限（2,000クエリ/日）がありますが、無料で利用できます。

URL Inspection APIとは？

URL Inspection APIは、Search Consoleの「URL検査」機能をプログラムから実行できるGoogle公式のAPIです。

通常、インデックス状況を確認するにはSearch Consoleを開いて1件ずつURLを入力する必要がありますが、このAPIを使えばスプレッドシートやスクリプトから一括でデータを取得できます。

Search Console APIの機能の一つとして提供されており、利用は無料ですが、1日あたり2,000リクエストの上限があります。

Google Search Console APIでできることや使い方については、「Google Search Console APIとは？できること4つと使い方を解説」で詳しく解説しています。

URL Inspection APIで取得できる4つの検査結果

URL Inspection APIでは、以下4種類の検査結果を取得できます。

検査項目	内容	備考
インデックスステータス	インデックス登録状況、クロール日時、正規URLなど	本ツールで取得
AMP	AMPページの検査結果、AMP固有のエラー	AMPページのみ
モバイルユーザビリティ	モバイル対応状況の検査結果	現在は非推奨
リッチリザルト	構造化データの検出結果、リッチリザルトの問題	構造化データがある場合のみ

それぞれ詳しく見ていきます。

インデックスステータス（IndexStatusInspectionResult）【本ツールで取得】

ページがGoogleにインデックスされているかどうか、クロールの状況はどうかなど、SEOの基本となる情報を取得できます。本ツールではこの情報を取得しています。

項目	内容
verdict	インデックス登録の総合判定（有効 / エラー / 除外 など）
coverageState	Googleがページを検出してインデックス登録できたかどうか
robotsTxtState	robots.txtでクロールがブロックされていないか
indexingState	noindexでインデックス登録がブロックされていないか
lastCrawlTime	Googleが最後にクロールした日時
pageFetchState	ページ取得の状態（成功 / 404 / 5xxエラー など）
googleCanonical	Googleが正規として選択したURL
userCanonical	サイト側でcanonicalとして指定したURL
sitemap	このURLが記載されているサイトマップ
referringUrls	このURLにリンクしている参照元URL
crawledAs	クロールに使用されたユーザーエージェント（デスクトップ / モバイル）

各項目の詳細な値については「取得データの見方」で解説しています。

インデックスされていないページ数は、サーチコンソールで簡易的にチェックできます。詳しくは「「インデックスに登録されていないページ数」の確認方法と対処法」を参考にしてください。

AMP（AmpInspectionResult）

AMPページを持つサイトの場合、AMP固有の検査結果を取得できます。AMPページがない場合、このデータは返されません。

項目	内容
verdict	AMPとしての総合判定
ampUrl	検査されたAMPページのURL
robotsTxtState	robots.txtでブロックされていないか
indexingState	noindexでインデックス登録がブロックされていないか
ampIndexStatusVerdict	AMP URLのインデックス登録ステータス
lastCrawlTime	AMPページが最後にクロールされた日時
pageFetchState	GoogleがAMPを取得できたかどうか
issues	検出されたAMPの問題と重大度（WARNING / ERROR）

モバイルユーザビリティ（MobileUsabilityInspectionResult）

モバイルユーザビリティの検査結果を取得できます。

項目	内容
verdict	モバイルユーザビリティの総合判定
issues	検出された問題のリスト

※この項目は現在非推奨となっています。

リッチリザルト（RichResultsInspectionResult）

ページに構造化データがある場合、リッチリザルトの検査結果を取得できます。構造化データがない場合、このデータは返されません。

項目	内容
verdict	リッチリザルトの総合判定
detectedItems	検出されたリッチリザルトのリスト（タイプ別にグループ化）

【無料配布】URL Inspection APIを使ったチェックツールの初期設定方法

設定はそんなに難しくありません。以下の解説をもとに、ひとつずつ設定していきましょう。

事前準備として、以下が準備できていることを確認したうえで、設定を進めてください。

項目	説明
Googleアカウント	スプレッドシートとGCPで同じアカウントを使用
Search Consoleアカウント	チェック対象サイトが登録済み
管理者権限	対象サイトでの所有者または管理者権限

①スプレッドシートのコピー

まずは以下の手順でテンプレートを入手してください。

②GCPプロジェクトの作成とInspection APIの有効化

次に、Google Cloud Platformでプロジェクトを作成し、「Search Console API（Inspection API）」を有効化しましょう。

「Search Console API」の機能のひとつとして、Search Consoleのインデックス状態を取得できる「Inspection API」を使用できます。

Google Cloud Platformからコンソールを開く

まずは「Google Cloud Platform」を開いてください。

※Googleのアカウントを持っていない人は作成してください（≫Googleアカウント作成）

その後、右上の「コンソール」をクリックしてください。

以下のような画面が表示されればOKです。

GCPプロジェクトの作成

次に、GCPプロジェクトの作成を行いましょう。

まず、Google Cloudのロゴ右側にあるボックスをクリックしてください。

その後、開かれたモーダルの右上にある「新しいプロジェクト」をクリックしてください。

その後、プロジェクト名にわかりやすい名前をつけましょう。（今回は「Inspection API」とします。）

左上のボックスが、作成したプロジェクト名「Inspection API」になっていればプロジェクトの作成は完了です。 作成したプロジェクト名になっていない場合は、左上のボックスをクリックして変更してください。

「Search Console API」の有効化

次に、「Search Console API」の有効化を行いましょう。

まずは、画面左上のハンバーガーメニューをクリックしてください。

次に、「APIとサービス > ライブラリ」をクリックしてください。

上記の方法で「APIとサービス」にアクセスできない場合は、ダッシュボードの「クイックアクセス > APIとサービス」をクリックしてください。

その後、画面左側のタブから「ライブラリ」をクリックしてください。

次に、検索バーに Search Console API と入力し、検索してください。

その後、Search Console APIの詳細画面に移動し、「有効化」をクリックしてください。

上の画像のように**「APIとサービス > 有効なAPIとサービス >」内に「Search Console API」が表示されていれば、APIの有効化は完了です。**

OAuth同意画面の設定

次にプロジェクトのOAuth同意画面の設定を行いましょう。

OAuth同意画面を設定することで、スプレッドシートからInspection APIを利用できるようになります。

まずは、上部の検索バーに OAuth と入力して、「OAuth同意画面」をクリックしてください。

以下の画面が表示されたら「開始」をクリックしてください。

アプリ名に Inspection API、ユーザーサポートメールに Googleアカウントのメールアドレス を入力して「次へ」をクリックしてください。

外部 を選択して「次へ」をクリックしてください。

外部 を選択してテストユーザーに許可したユーザーのみを登録すれば、他の人に使われる心配がなくなります。

メールアドレスに ご自身のメールアドレス を入力して「次へ」をクリックしてください。

最後に Google APIサービス: ユーザーデータに関するポリシー を確認し、問題なければチェックマークを付けて「作成」をクリックしてください。

これでOAuth同意画面の設定が完了となります。

テストユーザーの登録

次にテストユーザーを登録しましょう。

テストユーザーに任意のユーザーを登録することで、デプロイせずにAPIを使用できます。

まず、サイドバーの「対象」をクリックし、「+Add users」をクリックしてください。

次に テストユーザーに登録したいGoogleアカウントのメールアドレス を入力して「保存」をクリックしてください。複数のメールアドレスを登録することもできます。（100件まで）

ユーザー情報にメールアドレスが記載されていれば登録完了です。

プロジェクト番号のコピー

最後に、上部の検索バーに Inspection API と入力し、先ほど作成したプロジェクトのトップページに移動してください。

そこに表示されるプロジェクト番号をコピーしておきましょう。

このプロジェクト番号は、スプレッドシートと連携させるために後で使います。

③Google Apps Scriptの設定

次にGoogle Apps Script（GAS）の設定を行いましょう。 ここでは、「appsscript.jsonの表示設定」と「GCPプロジェクト番号の入力（APIの連携）」を行います。

まずは以下の手順でApps Scriptエディタを開いてください。

appsscript.jsonの表示設定

appsscript.jsonを表示させるため、左側のサイドバーから「プロジェクトの設定（歯車マーク）」を開いてください。

その後、「appsscript.json」マニフェスト ファイルをエディタで表示する にチェックを入れてください。

GCPプロジェクト番号の入力（APIの連携）

GCPのプロジェクト番号に、先ほどコピーしておいたプロジェクト番号を入力してください。

正常に保存されればGASで行う設定は完了です。

④初回実行時の権限設定

次に初回実行時の権限許可の方法について解説します。

スプレッドシートを更新する

スプレッドシートに戻り、再読み込みしてください。

その後、上部に「インデックス状況チェック」というメニューが表示されていることを確認してください。

権限の承認

次に、「インデックス状況チェック」→「手動実行」をクリックしてください。

「OK」をクリックしてください。

Googleアカウントを選択してください。

「続行」をクリックしてください。

「すべて選択」にチェックを入れて、「続行」をクリックしてください。

以下のように**「C7セルに対象ドメインを入力してください」というエラーが表示されれば、正しく動作しています。**

⑤ドメイン・URLの入力とテスト

次に、ドメインとURLを入力してテストを行いましょう。

以下のように、C7セルにドメインを、C12:CにチェックしたいURLを入力してください。

入力が完了したら、テストを行ってみましょう。「手動実行」または「自動実行を開始」をクリックしてみてください。

少し時間をおいて、以下のようにチェック結果列に情報が入力されたら、無事にツールが使える状態になっています。

インデックス一括チェックツールの使い方

インデックス状態チェックツールには以下の機能があります。

基本的には自動チェック機能のみ使用すればOKです。

自動実行機能

以下の設定を行うと、自動実行機能を使用できます。

自動実行ONにすると、以下のように動作します。

URLを新しく追加すると、次の自動実行で必ずチェックされます。すべて最新の場合はチェックされないようになっています。

自動実行を止めたい場合は、以下の手順で停止してください。

URLの大幅な追加・削除を行う時やしばらくチェックが不要な時、手動で処理を行いたい時に停止するようにしましょう。

手動実行機能

手動実行を行うには、メニュー「インデックス状況チェック」→「手動実行」をクリックしてください。正常に動作した場合は以下の処理が行われます。

データクリアと処理位置リセット

2種類のリセット機能があります。

データをクリアして処理位置リセット

新しいプロジェクトを始める時や古いデータを全部削除したい時など、一からやり直したい時に使います。

処理位置のみリセット

データは残して、最初から再チェックしたい時やエラーが多発した時の再処理、全URLを強制的に再取得したい時に使用します。

URL Inspection APIで取得できるデータの見方

URL Inspection APIを用いて、インデックス状態チェックツールで取得できる各データの見方を解説します。

※参考: Google Search Console API UrlInspectionResult

1. 判定結果（verdict）

総合的なインデックス登録状況の判定結果です。

値	意味	Search Console表記	説明
PASS	成功	有効	ページが正常にインデックス登録されている
FAIL	失敗	エラー・無効	重大な問題があり、インデックス登録されていない
NEUTRAL	中立	除外	インデックス登録されていないが、問題はない
PARTIAL	部分的	–	予約済み（現在未使用）
VERDICT_UNSPECIFIED	不明	–	判定結果が不明

2. robots.txt状態（robotsTxtState）

robots.txtファイルによるアクセス制御の状態です。

値	意味	説明
ALLOWED	許可	robots.txtでクロールが許可されている
DISALLOWED	拒否	robots.txtによってクロールがブロックされている
ROBOTS_TXT_STATE_UNSPECIFIED	不明	robots.txtの状態が不明（アクセスできない等）

3. インデックス状態（indexingState）

ページのインデックス登録可否の状態です。

値	意味	説明
INDEXING_ALLOWED	許可	インデックス登録が許可されている
BLOCKED_BY_META_TAG	メタタグでブロック	robotsメタタグで「noindex」が検出された
BLOCKED_BY_HTTP_HEADER	HTTPヘッダーでブロック	X-Robots-Tagヘッダーでnoindexが検出された
BLOCKED_BY_ROBOTS_TXT	robots.txtでブロック	予約済み（現在未使用）
INDEXING_STATE_UNSPECIFIED	不明	インデックス登録ステータスが不明

4. ページ取得状態（pageFetchState）

Googleがページを取得できたかどうかの状態です。

値	意味	HTTPステータス	説明
SUCCESSFUL	成功	200	ページの取得に成功
SOFT_404	ソフト404	200だが内容が404	正常応答だが404エラーページの内容
NOT_FOUND	未発見	404	ページが見つからない
ACCESS_DENIED	アクセス拒否	401	認証が必要（未承認）
ACCESS_FORBIDDEN	アクセス禁止	403	アクセスが禁止されている
SERVER_ERROR	サーバーエラー	5xx	サーバー側の内部エラー
BLOCKED_ROBOTS_TXT	robots.txtブロック	–	robots.txtによってブロック
BLOCKED_4XX	その他4xxエラー	4xx	403、404以外の4xxエラー
REDIRECT_ERROR	リダイレクトエラー	3xx	リダイレクトの問題
INTERNAL_CRAWL_ERROR	内部クロールエラー	–	Google側の内部エラー
INVALID_URL	無効なURL	–	URLの形式が無効
PAGE_FETCH_STATE_UNSPECIFIED	不明	–	取得状態が不明

5. クロールbot（crawledAs）

Googleがサイトクロールに使用したユーザーエージェントの種類です。

値	意味	説明
DESKTOP	デスクトップ	デスクトップ用のGooglebotでクロール
MOBILE	モバイル	モバイル用のGooglebotでクロール
CRAWLING_USER_AGENT_UNSPECIFIED	不明	ユーザーエージェントが不明

6. その他の項目

項目	説明
coverageState	Googleがページを検出してインデックスに登録できたかどうかの詳細状態
googleCanonical	Googleが選択した正規URL
userCanonical	サイト側で指定した正規URL
lastCrawlTime	最終クロール日時（RFC3339形式）
sitemap[]	このURLが記載されているサイトマップのリスト
referringUrls[]	このURLにリンクしているページのリスト

Inspection API利用時のよくあるエラーと対処法

よくあるエラーと対処方法は以下のとおりです。

「C7セルに対象ドメインを入力してください」

「このアプリは確認されていません」警告が再表示

この警告は自作スクリプトに対する一般的な警告です。

APIエラーが連続発生

処理が全く進まない

URL Inspection APIに関するよくある質問

よくある質問に回答します。

まとめ

このツールを導入することで、これまで手作業で行っていたインデックス確認作業を大幅に効率化できるでしょう。

Search Console APIの仕様上、リアルタイムでの大量処理はできませんが、自動実行機能と順次処理により実用的なレベルで活用していただけるはずです。

設定は少し複雑に感じるかもしれませんが、一度設定すれば長期間安定して利用できます。分からない点があっても、手順通りに進めれば必ず完了できるので、ぜひ挑戦してみてください。