You need to enable JavaScript to run this app. 如何在Google Cloud Datalab中通过Python SDK与服务账户连接Google Sheets?
优惠活动
大模型
产品
解决方案
定价
更多

如何在Google Cloud Datalab中通过Python SDK与服务账户连接Google Sheets?

报错核心原因

你遇到的403 scope权限不足报错,本质和代码逻辑、Sheet共享权限无关,是因为Google Cloud Datalab 底层运行的GCE虚拟机实例,在创建时就固化了OAuth授权范围,默认没有包含Google Sheets API的访问权限。
google.auth.default()方法在GCP运行环境下,默认读取的是实例本身绑定的服务账户已被授权的scope列表,你在代码里传入的scopes参数不会覆盖实例本身的固化授权范围,最终生成的访问令牌没有Sheets接口的权限,因此触发报错。

可行解决方案

方案1:重建Datalab实例时配置对应授权范围

如果你可以重建Datalab运行环境,在部署启动时添加对应的OAuth scope即可,两种配置方式二选一:

  • 授予全量Cloud Platform权限:启动参数添加--scopes=https://www.googleapis.com/auth/cloud-platform
  • 仅授予Sheets只读权限:启动参数添加--scopes=https://www.googleapis.com/auth/spreadsheets.readonly

方案2:手动加载服务账户密钥生成凭证(无需重建实例)

如果不想重启重建实例,可以跳过默认凭证获取逻辑,手动加载具备权限的服务账户密钥生成合法凭证:

  1. 在GCP IAM中新建服务账户,将目标Google Sheet共享给该服务账户的邮箱,下载该服务账户的JSON密钥文件,上传到Datalab的工作目录
  2. 修改原有代码的凭证加载部分:

适配Google APIs Python SDK的修改代码

from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build

# 替换为你上传的密钥文件路径
credentials = Credentials.from_service_account_file(
    'service_account_key.json',
    scopes=['https://www.googleapis.com/auth/spreadsheets.readonly']
)

service = build('sheets', 'v4', credentials=credentials)
sheet = service.spreadsheets()
result = sheet.values().get(spreadsheetId=GOOGLE_SHEET_ID,
                            range=SHEET_RANGE).execute()
values = result.get('values', [])

适配gspread的修改代码

import gspread
from google.oauth2.service_account import Credentials

# 替换为你上传的密钥文件路径
credentials = Credentials.from_service_account_file(
    'service_account_key.json',
    scopes=['https://www.googleapis.com/auth/spreadsheets.readonly']
)

gc = gspread.authorize(credentials)
sheet = gc.open_by_key(GOOGLE_SHEET_ID)
worksheet = sheet.get_worksheet(MY_WORKSHEET)

注意:使用手动加载密钥的方式时,不需要将Sheet共享给Datalab实例的默认服务账户,仅需共享给你新建的服务账户即可。

方案3:临时调试用的临时凭证方案

如果仅做临时调试,不需要长期运行,也可以通过临时下载用户凭证的方式绕过实例权限限制,调试完成后及时撤销凭证权限即可,不建议生产环境使用。

内容的提问来源于stack exchange,提问作者Petr Razumov

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 14:36:04