gsc access
Search Consoleに見えないサイトを3種類に切り分けた記録
APIで取得したサイト一覧に出てこないサイトを、まとめて「未登録」と呼んでいませんでしたか。2026年8月22日に保有ドメインを棚卸ししたとき、見えない理由は3種類あり、直し方も所要時間も違うことが分かりました。実際のサイトが数字の取れない状態で眠っていたので、切り分けの表と直した手順を残します。
このサイトはAnthropicの公式サイトではありません。Claude Codeの機能・料金・提供範囲は変わる可能性があるため、重要な判断の前には公式のドキュメントと自分のアカウント設定を確認してください。
先に結論：見え方で三つに分ける
| 見え方 | 実際の状態 | 直し方 |
|---|---|---|
| 人間のアカウントにもサイトが無い | 本当にプロパティが無い | 作成、所有権の確認、APIのサービスアカウントへの権限付与 |
| 人間のアカウントで「所有権未確認」 | 追加だけして確認が終わっていない | DNSのTXTかHTMLファイルで確認してから権限付与 |
| 人間のアカウントで所有者なのにAPIから見えない | 所有はできている。サービスアカウントを権限に足していないだけ | 「ユーザーと権限」にサービスアカウントを制限付きで追加 |
三番目はいちばん軽い症状で、追加した直後から過去180日ぶんの履歴がそのまま読めました。数字が無かったのではなく、見えていなかっただけです。
手順：自分のサイトで切り分ける
- APIで見えるサイト一覧と、人間のアカウントで見えるサイト一覧を、別々に取る。
- APIに無いサイトを、人間のアカウント側の権限レベル（所有者・確認済みユーザー・未確認ユーザー）ごとに分ける。
- どこにも無いサイトは、本番のHTMLに
google-site-verificationのmetaタグがあるか確かめる。 - 三つの型それぞれの直し方を実行する。
- 翌日、APIで表示回数が取れることを確かめる。
注意点があります。自作の一覧取得コードが「権限なし」のユーザーを除外して捨てていると、二番目の型が一覧から消えて見えなくなります。切り分けるときは権限レベルで落とさず、全部拾ってください。
見つけた落とし穴：metaだけ貼って終わった残骸
どのアカウントからも「アクセス権がありません」と出るのに、本番にはmetaタグがある、という型がありました。確認の画面を開いてmetaを貼ったところで作業が止まり、確認ボタンを押さないまま終わった残骸です。この場合プロパティは実質存在しません。ドメインプロパティを作り、DNSのTXTで確認します。Search Consoleが出すTXTの値は同じトークンなので、metaの値と一致すれば、同じアカウントの未完了の操作だったと確定できます。
直した後に確かめること
権限を足したら、その日のうちに次の三点を確かめます。一つ目は、APIの一覧に当該のサイトが出ること。二つ目は、直近の日付の表示回数が取得できること（取得できても値が0なら、まだ反映前の可能性があります）。三つ目は、検査や優先順位を計算する自作の道具が、新しく見えるようになったサイトを対象に含めること。三つ目を忘れると、見えるようにしたのに集計の対象にはならない、という二重の穴になります。
また、対象サイトの一覧を道具ごとに手書きで持っていると、追加したサイトが一部の道具にだけ入らないことがあります。一覧は一か所に置き、各道具はそこから読む形にしてください。詳しくは検査コードの書き方にあります。
一覧の取り方で見え方が変わる
サービスアカウントは、権限を足したサイトしか返しません。したがって、APIの一覧の件数が、人間のアカウントで見える件数より少ないのは、異常ではなく仕様です。むしろ両方の差を毎回出すことが、この種の漏れを見つける最も簡単な検査です。差の中身が、上の三つの型のどれかに必ず当てはまります。当てはまらない差が出たら、別の原因（ドメインプロパティとURLプレフィックスのプロパティが別々に登録されている、など）を疑ってください。
差を出す検査は数行で書けますし、月に一度でも走らせておけば、新しく取ったドメインが穴に落ちたまま数か月放置される事故を避けられます。
新しいドメインを取った日にやること
穴に落ちるのは、たいてい取得した日にやることを分割したときです。サイトを公開する、sitemapを置く、検索の管理画面に登録する、所有権を確認する、APIの読み取りを許可する、の五つを一つの手順書にして、最後の一つまで終えたら完了と書くと、途中で止まった残骸が残りにくくなります。完了の判定も、手順書にチェックを付けるのではなく、APIで翌日に数字が取れたことで行ってください。
実測：何が眠っていたか
2026年8月22日の棚卸しでは、本文が2,700〜8,900字ある実在のサイト7件がこの穴に落ちていました。内訳は、プロパティ自体が無いもの、所有権未確認のもの、サービスアカウントの権限が無いもの、の三種類です。所有権未確認だったサイトには、sitemapが100本を超えるのに180日ぶんが丸ごと未計測のものがありました。7件とも同日に解消しています。
権限なしだった4サイトのうち、追加の直後に履歴を読むと、すでにクリックと表示が出ているサイトもありました。成果が無かったのではなく、見ていなかった、というのがこの件の教訓です。このサイトも当時はその4件に含まれていました。
公式の記載で裏づける：権限と所有権の決まり（2026年11月15日確認）
ここまでの切り分けが、公式の仕様のどこに当たるかを並べます。Search Consoleのヘルプには次の記載があります。
- 権限の種類は、所有者・フルユーザー・制限付きユーザー・関係者（Associate）の4つ。関係者は、特定の操作やデータの取得を代行する立場で、管理画面やデータを自分では開けません。
- プロパティには、確認済みの所有者が少なくとも1人必要です。確認済みの所有者は、権限を下げられず、取り除くにはサイトから確認用のトークンを外します。
- 所有者には、トークンで確認した「確認済み」と、確認済みの所有者から確認なしで権限を渡された「委任」の2種類があり、権限は同じです。
- 所有者以外のユーザーは1プロパティにつき100人まで。委任された所有者は確認済みの所有者と合わせて500人までです。
- 最後の確認済み所有者がいなくなると、猶予期間のあとに残りのユーザーも権限を失います。
確認の方法は、HTMLファイル、HTMLタグ、Google Analytics、Google Tag Manager、ドメイン名プロバイダ（DNS）の5つです。HTMLファイルとHTMLタグはドメインプロパティには使えず、ドメインプロパティを確認できるのはDNSだけです。DNSでURLプレフィックスのプロパティを確認すると、ドメインプロパティも自動で確認されます。確認が済んだあとも、DNSのレコードは消さないでください。公式は、レコードを残すことが確認を保つ条件だと説明しています。手で追加したDNSレコードがプロバイダで反映されるまで、2〜3日かかることもあると書かれています。
APIの側では、サイト一覧を返すsites.listはGET https://www.googleapis.com/webmasters/v3/sitesで、webmasters.readonlyかwebmastersのスコープを要します。応答はsiteEntryの配列で、各サイトに権限レベルの情報が付きます。
出典：Google「Search Console の権限」「サイト所有権の確認」、Google for Developers「Search Console API sites.list」（2026年11月15日確認）。
よくある質問
サービスアカウントの権限は何にすればよいですか？
読むだけなので「制限付き」で足ります。追加した直後から過去の履歴を読めます。
所有権の確認はHTMLファイルとDNSのどちらがよいですか？
複数のサイトを持つなら、ドメイン単位で一度確認すれば配下をまとめて扱えるDNSのTXTが管理しやすいです。
見えないサイトがあると何が困りますか？
検査や優先順位の計算から、そのサイトが丸ごと落ちます。一覧に無いことに気づけないまま、数字が良いサイトだけを見て判断することになります。