GSC 網站管理指南
本指南說明如何在 GIIP 平台中管理已註冊到 Google Search Console 的網站。
📋 概述
GSC 網站管理是 GIIP 平台提供的功能,可讓您直接管理已註冊到 Google Search Console 的網站(網域/URL 前綴)。為每個網站註冊 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時,最常見的原因就是這一個斜線的差異。請直接複製 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值。 - 將權限層級設為 完整(或更高),然後儲存。
- 完成後最多一天(每日批次週期)內即可收集到資料。如需立即確認,請在 GA/GSC 收集管線 頁面的 GSC 區段使用 [開始收集] 按鈕。
💡 很多情況下會直接重複使用 GA4 的服務帳號金鑰。此時必須同時在 GA4 資源存取權限管理 和 Search Console 使用者和權限 中授予權限,兩條管線才能都正常運作。
2. 編輯 GSC 網站
- 在清單中找到要編輯的網站列。
- 點擊該列的 [編輯] 按鈕。
- 在表單中修改相應值(標籤、金鑰等)。
- 再次點擊 [更新] 按鈕儲存。
- 如需取消編輯,點擊 [取消] 按鈕。
3. 刪除 GSC 網站
- 在清單中找到要刪除的網站列。
- 點擊該列的 [刪除] 按鈕。
- 在確認對話框中點擊 確定。
4. 查看金鑰狀態
- 清單中的 金鑰狀態 欄顯示每個網站的金鑰註冊狀態。
- 已註冊(綠色徽章):已註冊服務帳號金鑰,可查詢 Search Console 資料。
- 未註冊(灰色徽章):未註冊金鑰,目前無法擷取資料。如需註冊金鑰,請點擊 [編輯] 貼上 JSON 金鑰。
💡 使用技巧
- 多網站管理:您可以在單個 GIIP 組織(CSN)下管理多個網域/子網域。使用標籤可以輕鬆區分它們。
- 金鑰管理:請在 Google Cloud Console 中監控服務帳號金鑰的到期日期,並定期更新。金鑰到期後,「金鑰狀態」將顯示為「未註冊」。
- 網域 vs URL 前綴:
sc-domain:方式(網域驗證)涵蓋所有子網域,而 URL 前綴方式僅涵蓋特定路徑。請根據需要選擇合適的方式。
疑難排解
| 症狀 | 原因 | 解決方法 |
|---|---|---|
| 顯示錯誤「沒有選中的組織 (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,而實際資源為 https://example.com/)— Search Console 將兩者視為不同資源並回傳 403 | 複製 Search Console 左側資源下拉選單中顯示的確切字串(包括是否帶斜線),然後點擊 [編輯] 用該確切值重新儲存 GSC 網站欄位。 |
| 顯示錯誤「沒有此組織的權限」 | 目前使用者沒有該 CSN 的權限 | 請向組織管理員申請權限。 |
版本: 1.0
最後更新: 2026-08-05
來源檔案: giipv3/public/help/gsc-property.zh-TW.md