本页要点
- 只需要在 GSC 里加一个「受限」用户，不需要给 Google 账号密码。
- 域名属性（sc-domain:）和网址前缀属性是两个资源，要分别添加。
- 授权只影响取数，不会改你的网站或 GSC 设置。
配图占位 · 待补
GSC 添加只读用户
Search Console「设置 → 用户和权限 → 添加用户」界面，填入服务账号邮箱、权限选择「受限」。
- 圈出「添加用户」入口
- 显示权限下拉为「受限」
- 邮箱可用示例值，不出现真实账号
建议文件：docs-gsc-auth-01.webp /public/assets/docs/docs-gsc-auth-01.webp，再将本占位替换为图片。 先分清你用的是哪个属性
| 显示形式 | 属性类型 | 说明 |
|---|---|---|
https://www.example.com/ | 网址前缀属性 | 只覆盖这个协议 + 域名 + 路径前缀 |
sc-domain:example.com | 域名属性 | 覆盖该域名所有协议和子域 |
两个都建议加。工作台默认按站点地址匹配属性；用域名属性时，在站点编辑里把 GSC 属性写成 sc-domain:example.com。
添加服务账号
-
打开用户和权限
Search Console 左侧最下方「设置」→「用户和权限」→ 右上角「添加用户」。
-
填入服务账号邮箱
复制工作台「流量数据接入」里显示的服务账号邮箱。当前是
id-417@neat-element-510309-g6.iam.gserviceaccount.com，以页面显示为准。 -
权限选「受限」
观象台只需要读搜索表现，不需要「完全」或「所有者」。
-
点添加
不需要勾选「通知新用户」。Google 通常几分钟内生效。
验证与撤销
添加后回工作台点「同步 GSC 数据」。能看到点击、曝光、关键词和页面数据，就通了。GSC 数据本身延迟 2–3 天，当天看不到最新一天是正常的，时间线见 多久见效。
撤销时回到「用户和权限」，删掉服务账号那一行即可，立即生效。具体报错见 常见报错。
做完检查
- 我确认了当前用的是域名属性还是网址前缀属性。
- 服务账号邮箱完整复制，权限是「受限」。
- 工作台已经能拉到 GSC 数据。
- 我知道怎么移除这个用户。