6分钟阅读

GSC 网站管理指南

本指南介绍如何在 GIIP 平台中管理已注册到 Google Search Console 的网站。

🏢 前往 GSC 网站管理页面 →

📋 概述

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-CN.md