Search Console APIとSEOツールの接続構造
SEOツールがSearch Consoleのデータを取得するには、Google Search Console APIを経由します。APIを介した接続はUI操作とは異なる制約が課されており、仕様を理解していないと予期しない挙動の原因を特定できません。
APIバージョンと認証方式の概要
Search Console APIは現在v3が主流です。APIへのアクセスにはOAuth 2.0による認証が必要で、連携に使用するGoogleアカウントが対象プロパティでオーナーまたは完全ユーザー権限を持っている必要があります。SEOツールはOAuthトークンで認証を通過してデータ取得リクエストを送ります。トークンには有効期限があり、パスワード変更や二段階認証の変更をきっかけに無効化されることがあるため、定期的な確認が必要です。
この記事をご覧の方には、以下の記事もおすすめです。あわせて参考にしてください。
Search Performance APIとURL Inspection APIの違い
SEOツールが主に使用するAPIは2種類あります。クリック数・表示回数・CTR・掲載順位を取得するSearch Performance APIと、特定URLのインデックス状況を確認するURL Inspection APIです。Search Performance APIではクエリ・ページ・国・デバイスのディメンションを指定してフィルタリングできますが、指定方法が正確でないとレスポンスが空で返ってきます。どのAPIを使ってどのデータを取得しているかを把握しておくと、違和感があったときの原因特定が速くなります。
データ遅延の仕様とSEOツールへの影響
Search Consoleのパフォーマンスデータには、検索が行われてから反映されるまでに一定のタイムラグがあります。これはAPIの問題ではなくGoogleの仕様であり、SEOツールで確認できるデータの最新性に直接影響します。
通常2～3日のタイムラグが生じる理由
Googleは検索トラフィックのデータを一定の処理を経てからSearch Consoleに反映します。このため、実際の検索日から通常2～3日後にデータが反映されます。SEOツールがAPIから「データなし」の応答を受け取っても、本当にデータがないのか単に未反映なのかを区別するには、日付と経過日数の確認が必要です。ダッシュボードで最新日付が空欄でも、2～3日後に確認すれば正常に表示されることがほとんどです。
直近データの修正と確定までの期間
APIから取得できる直近のデータは確定値ではなく、数日後に再取得すると数値が変わっていることがあります。SEOツールが取得データをキャッシュしていると修正後の確定値に更新されないまま古い数値が表示され続ける場合があるため、直近7日間のデータは参考値として扱うことをお勧めします。
長期間のデータ取得における制限（16ヶ月ルール）
Search Console APIで取得できるパフォーマンスデータは過去16ヶ月分が上限です。新規導入時に長期データを遡って取得しようとしても16ヶ月より前は取得できません。この制限はGoogleの仕様として固定されており、長期トレンド分析にはSEOツールが独自に蓄積したデータや別の分析手段で補完する運用が現実的です。
プロパティ権限とアクセス設定がデータ取得に与える影響
Search Consoleでは、どのプロパティに誰がアクセスできるかを権限で管理します。この権限設定がAPIを通じたデータ取得にも直接影響するため、SEOツールの連携設定と合わせて理解しておく必要があります。
プロパティタイプ（ドメイン／URLプレフィックス）の違い
Search Consoleのプロパティには「ドメインプロパティ」と「URLプレフィックスプロパティ」の2種類があります。ドメインプロパティはHTTP・HTTPS・wwwあり・なしを含めたドメイン全体を一括で管理でき、DNSのTXTレコード認証が必要です。一方のURLプレフィックスプロパティは特定のURLから始まるページのみを対象とし、HTMLタグやGoogleアナリティクスなど複数の認証方法が使えます。
SEOツールがAPIで接続するプロパティがどちらのタイプかによって、取得できるデータの範囲が変わります。サイト全体のデータが欲しい場合はドメインプロパティと連携するのが適切ですが、URLプレフィックスプロパティに接続していると一部のサブドメインやプロトコルのデータが含まれないことがあります。連携設定を確認する際は、プロパティタイプと取得したいデータ範囲が一致しているかを確かめてください。
この記事をご覧の方には、以下の記事もおすすめです。あわせて参考にしてください。
権限レベルとAPIアクセスの関係
APIでパフォーマンスデータを取得するには、連携に使うアカウントが対象プロパティでオーナーまたは完全ユーザー権限を持っている必要があります。制限付きユーザー権限ではAPIアクセスが制限されデータを正常に取得できません。担当者の異動があった際は連携用アカウントの権限を確認し、SEOツールが「接続中」でも実際にデータが更新されているかを目視確認することをお勧めします。
複数プロパティを持つサイトの管理上の注意点
大規模サイトや多言語サイトでは複数のSearch Consoleプロパティを運用するケースがあります。SEOツールが連携できるプロパティ数はツールによって異なり、プロパティごとにAPIクォータのカウントが異なる場合もあります。複数プロパティを統合管理したい場合は、ドメインプロパティでサイト全体をまとめるか、複数プロパティの一括取得に対応したSEOツールを選ぶことをお勧めします。
ITトレンドでは、最新の製品・サービスを多数比較・掲載しています。まず資料を取り寄せ、製品の機能や特徴を比較してみてください。忙しい業務時間内でも、各社に問い合わせる手間なく、たった1回の入力（約60秒）でSEOツールの一括資料請求が可能です。浮いた時間で、じっくりと製品を比較検討し進めましょう。
サンプリングの仕様とデータ精度への影響
Search Console APIから取得できるデータは、条件によってすべての行が返らない場合があります。Search Analytics APIは内部制限により、全データ行を返す保証はなく、クリック数上位の行が返されます。また、1回のリクエストで返せる行数には上限があります。
サンプリングが発生する条件と見分け方
クエリ・ページ・国・デバイスの4ディメンションを同時に指定して大量データを要求した場合、Googleがデータを間引いて返すことがあります。APIレスポンスにはサンプリング適用の有無を示すフラグが含まれています。取得件数が上限（最大25,000行）に達していない場合や、クエリ合計が管理画面の集計値と乖離している場合はサンプリングが発生していると疑ってください。
サンプリングを抑えるAPIリクエストの組み方
サンプリングの影響を最小限に抑えるには、一度に取得するデータの範囲を絞ることが有効です。日付範囲を短く区切り、ディメンションの組み合わせを減らしてリクエストすることで、サンプリングが発生しにくくなります。1週間単位でデータを分割取得してツール側で結合するアーキテクチャを採用しているSEOツールは、この問題に対処しています。
クエリディメンションを含む場合はサンプリングが特に発生しやすいため、クエリを含まないページ・国・デバイスの集計とクエリを含む集計を分けて取得する設計も有効です。利用しているSEOツールがどのようにAPIリクエストを組んでいるかは、ツールのドキュメントやサポートに確認することをお勧めします。
管理画面のデータとAPIデータが一致しない理由
管理画面とAPIで数値が一致しない場合、サンプリングに加えてデフォルトの集計設定の違いが原因です。管理画面はウェブ検索のみをデフォルトで表示しますが、APIは検索タイプを指定しないとウェブ・画像・動画を含めることがあります。数値のズレが気になる場合は、APIリクエスト時の検索タイプ指定とフィルタ条件を管理画面の設定と揃えて比較すると差異の原因を絞り込めます。
APIクォータの仕組みと上限管理の実践
Search Console APIにはリクエスト数の上限（クォータ）が設けられており、超過するとデータ取得が失敗します。クォータの仕組みを理解して適切に管理することで、連携エラーを防ぎながら必要なデータを安定して取得できます。
クォータの種類と上限値
Search Console APIのクォータはプロジェクト単位で管理されます。デフォルトでは1日あたり2,000リクエスト、1分あたり200リクエストが上限で、超過すると429エラー（Too Many Requests）が返されます。上限はGoogle Cloud ConsoleのSearch Console APIページから引き上げ申請できますが、承認はGoogleの審査次第です。まず現状のリクエスト数を把握してから申請を検討することをお勧めします。
複数ツール併用時のクォータ競合への対処
同一のGoogle Cloud ProjectまたはGoogleアカウントを通じて複数のSEOツールがAPIにアクセスしている場合、クォータが合算されます。あるツールが大量リクエストを出すと、別のツールのデータ取得が失敗するという競合が起きます。
対処としては、ツールごとに異なるGoogle Cloud Projectを割り当ててクォータを分離する方法があります。また、各ツールのデータ取得スケジュールを時間帯でずらすことで、一時的なリクエスト集中を避けることもできます。不要になったツールや使用頻度の低いツールは連携を解除してリクエスト数を減らすことが、最も直接的な対処です。
この記事をご覧の方には、以下の記事もおすすめです。あわせて参考にしてください。
Search Console API連携のよくある質問
Search Console APIの仕様に関連してSEOツール担当者からよく寄せられる質問をまとめました。
- ■Q1：SEOツールのダッシュボードで最新3日分のデータが空欄です。APIエラーですか？
- APIエラーではなくSearch ConsoleのAPI仕様によるものです。パフォーマンスデータはGoogleの集計処理を経て反映されるため、検索が行われた日から通常2～3日のタイムラグがあります。3～4日後にデータが埋まっていれば正常です。Search Consoleの管理画面で同じ日付を確認し、そちらにもデータがなければGoogleの処理が未完了である可能性が高いです。
- ■Q2：取得できるクエリ数がSearch Consoleの管理画面より少ないのはなぜですか？
- APIのサンプリング仕様が原因と考えられます。特にクエリ・ページ・国・デバイスの複数ディメンションを組み合わせたリクエストではサンプリングが発生しやすく、管理画面で確認できる全件数より少ない件数しかAPIから返ってこないことがあります。日付範囲を短く区切って取得するか、ディメンションを分けて複数回リクエストする方法で件数を増やせる場合があります。
- ■Q3：ドメインプロパティとURLプレフィックスプロパティ、どちらをSEOツールと連携すべきですか？
- サイト全体のデータを一元管理したい場合はドメインプロパティとの連携を推奨します。ドメインプロパティはHTTPSとHTTP、wwwあり・なしを含めたすべてのデータを一つにまとめて取得できます。一方、特定のサブディレクトリやサブドメインだけを監視したい場合はURLプレフィックスプロパティが適しています。連携前にサイトの構成と必要なデータ範囲を確認し、プロパティタイプを選んでください。
まとめ
Search Console APIには、データ遅延・プロパティ権限・サンプリング・クォータという4つの主要な仕様・制限があります。これらはAPIエラーとして画面に表示されないことが多く、把握していないとデータの欠落や数値のズレを見過ごします。
データ遅延は通常2～3日あり直近値は後から修正されます。プロパティ権限はオーナーまたは完全ユーザーが必要で、アカウント変更時は引き継ぎ確認が欠かせません。サンプリングはディメンションを絞ったリクエスト設計で抑えられ、クォータはツール統合とスケジュール分散で管理できます。GA4やLooker Studioとの連携エラーは別記事で解説していますので、あわせてご確認ください。
