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つと使い方を解説」で詳しく解説しています。

≫inSiteで全ページのインデックス状況を把握してみる（無料）

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	検出されたリッチリザルトのリスト（タイプ別にグループ化）

≫inSiteで全ページのインデックス状況を把握してみる（無料）

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

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

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

STEP1：スプレッドシートのコピー

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

1. 配布用スプレッドシートにアクセス
2. 「ファイル」→「コピーを作成」をクリック
3. 分かりやすい名前に変更（例：「Search Console インデックス状態チェックツール（〇〇ブログ））

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

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

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

初めてGCPを使う方へ
Google Cloud Platformは、Googleが提供するクラウドサービスです。
今回はAPIの利用権限を得るために使用します（無料で利用可能）。

Google Cloud PlatformでGCPでプロジェクトを作成し、「Search Console API（Inspection API）」を有効化する方法は以下のとおりです。

STEP3：Google Apps Scriptの設定

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

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

1. 先ほどコピーしたスプレッドシートを開く
2. 上部のメニューから「拡張機能」→「Apps Script」をクリック
3. 新しいタブでApps Scriptエディタが開きます

STEP4：初回実行時の権限設定

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

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

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

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

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

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

≫inSiteで全ページのインデックス状況を把握してみる（無料）

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

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

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

自動実行機能

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

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

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

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

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

手動実行機能

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

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

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

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

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

この機能を使うことで、以下の処理が実行されます。

処理位置のみリセット

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

この機能を使うことで、以下の処理が実行されます。

≫inSiteで全ページのインデックス状況を把握してみる（無料）

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にリンクしているページのリスト

≫inSiteで全ページのインデックス状況を把握してみる（無料）

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

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

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

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

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

API エラーが連続発生

処理が全く進まない

≫inSiteで全ページのインデックス状況を把握してみる（無料）

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

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

≫inSiteで全ページのインデックス状況を把握してみる（無料）

まとめ

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

特に以下のような方におすすめです。

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

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