GSC サイト管理ガイド
Google Search Console に登録したサイトを GIIP プラットフォームで統合管理する方法を説明します。
📋 概要
GSC サイト管理は、Google Search Console に登録されたサイト(ドメイン/URL プレフィックス)を GIIP から直接管理できる機能です。各 사이트に Google Cloud サービスアカウントの JSON キーを登録すると、GIIP が Search Console データを自動取得します。
🔍 主要用語
| 用語 | 説明 |
|---|---|
| GSC サイト | Google Search Console に登録されたサイトです。sc-domain: 接頭辞(ドメイン確認用)または通常の URL(https://...)形式で登録します。 |
| ラベル | サイトを区別するためのユーザー定義名です。例:「マーケティングサイト」「ブログ」 |
| サービスアカウントキー(JSON) | Google Cloud で生成したサービスアカウントの JSON キーファイル内容です。Search Console データへのクエリ権限を付与します。 |
| 有効/無効 | 当該 GSC サイトの状態です。無効状态的 사이트はデータ取得から除外されます。 |
| キー状態 | サービスアカウントキーが登録されているかどうかです。「登録済み」(緑バッジ)であれば、GIIP がそのサイトの Search Console データを取得できます。 |
🛠️ 操作方法
1. GSC サイトを登録する
- GIIP 左メニューから [インフラ管理] > [GSC サイト管理] へ移動します。
- GSC サイト 入力欄に Google Search Console に登録したサイトアドレスを入力します。
- ドメイン確認方式(
sc-domain:)の場合:sc-domain:example.comと入力 - URL プレフィックス 方式の場合:
https://www.example.com/と入力 - ⚠️ URL プレフィックス方式では末尾のスラッシュ(
/)まで一字一句正確に一致させる必要があります。 Search Console はhttps://example.com(スラッシュなし)とhttps://example.com/(スラッシュあり)を別のプロパティとして扱います。権限を正しく付与したのに収集が403 Forbiddenで失敗し続ける原因として最も多いのがこのスラッシュ1文字の不一致です。Search Console 左側のプロパティ選択ドロップダウンに表示されている文字列をそのままコピーしてください。
- ドメイン確認方式(
- ラベル 入力欄にサイトを区別する名前を入力します。例:「マーケティングサイト」
- GSC サービスアカウントキー(JSON) 入力欄に Google Cloud サービスアカウントの JSON キーファイルの内容を貼り付けます。
- 既存のキーを維持したい場合は空のままにしてください。
- キーを交換する場合は、新しい JSON 内容を貼り付けて [更新] をクリックしてください。
- ⚠️ キーを保存しただけではデータは収集されません。 下記「サービスアカウントに Search Console のアクセス権限を付与する」まで必ず完了してください。
- [追加] ボタンをクリックして保存します。
🔑 サービスアカウントに Search Console のアクセス権限を付与する(必須)
GA4 と Search Console は別々の Google サービスで、権限もそれぞれ別に付与する必要があります。同じサービスアカウントキーをすでに GA4 で使っていても、Search Console 側に別途ユーザー追加をしないと、収集は 403 Forbidden で失敗し続けます。
- アップロードした JSON キーファイルを開き、
client_emailの値を確認します(例:xxxx@your-project.iam.gserviceaccount.com)。 - サイト所有者アカウントで Google Search Console にログインします。
- 登録するプロパティ(サイト)を選択します。
- 左下の 設定(⚙️) → ユーザーと権限 に移動します。
- ユーザーを追加をクリックし、1 で確認した
client_emailの値を貼り付けます。 - 権限レベルを フル(またはそれ以上)に設定して保存します。
- 完了後、最大1日(自動バッチ周期)以内にデータが収集されます。すぐに確認したい場合は GA/GSC 収集パイプライン ページの GSC セクションにある [収集開始] ボタンを使用してください。
💡 GA4 用のサービスアカウントキーをそのまま再利用するケースが多いですが、その場合は GA4 のプロパティアクセス管理と Search Console のユーザーと権限の両方に権限を付与しないと、両方のパイプラインは正常に動作しません。
2. GSC サイトを編集する
- 목록에서 수정할 사이트 행을 찾습니다.
- 해당 행의 [수정] 버튼을 클릭합니다.
- 입력 폼에 수정할 값(라벨, 키 등)을 변경합니다.
- [수정] 버튼을 다시 클릭하여保存합니다.
- 수정을 취소하려면 [취소] 버튼을 클릭합니다.
3. GSC サイトを削除する
- 목록에서 삭제할 사이트 행을 찾습니다.
- 해당 행의 [削除] ボタンをクリックします.
- 確認ダイアログで OK をクリックします.
4. キー状態を確認する
- 一覧の キー状態 列で各サイトのキー登録状況を確認できます.
- 登録済み(緑バッジ):サービスアカウントキーが登録されており、Search Console データのクエリが可能です.
- 未登録(灰バッジ):キーがなく、現在はデータが取得できません。キーを登録するには [編集] から JSON キーを貼り付けてください.
💡 活用のヒント
- 複数サイト管理: 複数のドメイン/サブドメインを1つの GIIP 組織(CSN)で管理できます。ラベル用于하면 구분하기 쉽습니다.
- キー管理: Google Cloud Console でサービスアカウントキーの有効期限を確認し、定期的に更新してください。キーが期限切れになると「キー状態」が「未登録」に表示されます。
- ドメイン vs URL プレフィックス:
sc-domain:方式(ドメイン確認)はサブドメイン全体を含むのに対し、URL プレフィックス方式是特定の 경로만 포함합니다。必要な 범위에 맞게選択하세요。
問題解決
| 症状 | 原因 | 解決方法 |
|---|---|---|
| 「選択された組織(CSN)がありません」エラーが表示される | ログインユーザーに組織(CSN)が割り当てられていない | GIIP 管理者に連絡して組織の割り当てを依頼してください。 |
| 保存時に「有効な JSON 形式ではありません」エラー | JSON キー欄に正しくない内容が入力されている | Google Cloud Console からサービスアカウントの JSON キーファイルを再ダウンロードして、内容をそのまま貼り付けてください。 |
| 登録した사이트가 목록에 표시되지 않음 | Search Console にそのサイトが登録されていないか、権限がない | まず Google Search Console(https://search.google.com/search-console)でサイトの所有権を確認してください。 |
| キー状態が「未登録」と表示される | サービスアカウントキーが入力されていないか、期限切れ | [編集] をクリックして有効なサービスアカウント JSON キーを貼り付けてください。 |
| 収集パイプラインに 「403 (Forbidden)」 エラーが表示される | キーは登録済みだが、そのサービスアカウントが Search Console 側のユーザーとして追加されていない(GA4 の権限とは別) | 上記「サービスアカウントに Search Console のアクセス権限を付与する」の手順で、そのプロパティにサービスアカウントをユーザーとして追加してください。 |
| サービスアカウントをフル権限で正しく追加したのに「403 (Forbidden)」が続く | GSC サイト欄に入力した URL が実際に検証済みのプロパティと 末尾スラッシュ(/)の有無が異なる(例: 登録値 https://example.com vs 実際のプロパティ https://example.com/)— Search Console はこれらを別プロパティとして扱い 403 を返す | Search Console 左側のプロパティドロップダウンに表示されている正確な文字列(スラッシュの有無を含む)をコピーし、[編集] から GSC サイト欄を再保存してください。 |
| 「この組織に対する権限がありません」エラー | 現在のユーザーに해당 CSN 에 대한 권한이 없음 | 組織の管理者に権限付与を依頼してください。 |
バージョン: 1.0
最終更新日: 2026-08-05
ソースファイル: giipv3/public/help/gsc-property.ja.md