如何在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:手动加载服务账户密钥生成凭证(无需重建实例)
如果不想重启重建实例,可以跳过默认凭证获取逻辑,手动加载具备权限的服务账户密钥生成合法凭证:
- 在GCP IAM中新建服务账户,将目标Google Sheet共享给该服务账户的邮箱,下载该服务账户的JSON密钥文件,上传到Datalab的工作目录
- 修改原有代码的凭证加载部分:
适配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
相关产品推荐
相关产品推荐

