使用Google Spreadsheet API自动化报表遇权限及授权问题求助

一、Service Account 模式下 TransportError 解决 #

• 核对JSON密钥路径：代码里要确保service_account_file指向你下载的JSON文件的绝对路径（本地运行），或是已正确上传到Colab的文件路径（Colab运行时先完成密钥文件上传）。
• 确认API权限开启：登录Google Cloud Console的API库，检查Google Sheets API和Google Drive API是否都已启用——创建表格依赖Drive API，很多人会漏掉这一步。
• 配置Service Account共享权限：如果要操作指定的Workspace文件夹或表格，把JSON文件里client_email字段对应的邮箱，添加到目标资源的共享列表，赋予编辑权限。
• 排查网络问题：TransportError大多和网络连接有关，本地运行时检查能否正常访问Google API域名；Colab环境一般无需额外设置，但企业网络可能需要配置代理。

二、OAuth Client ID 模式下 Colab 授权的 localhost 问题 #

Colab是云端环境，默认本地回调会导致localhost无法访问，换用云端授权流程即可解决：

• 用Colab内置授权逻辑替代本地OAuth flow，示例代码：

  from google.colab import auth
  auth.authenticate_user()
  
  import gspread
  from google.auth import default
  creds, _ = default()
  
  gc = gspread.authorize(creds)
  # 创建表格示例
  sh = gc.create('My new spreadsheet')
  

• 若坚持用自定义OAuth Client ID，需在Google Cloud Console的OAuth同意屏幕中，添加https://colab.research.google.com/作为授权回调URL，再修改代码：

  from google.oauth2.credentials import Credentials
  from google_auth_oauthlib.flow import InstalledAppFlow
  
  SCOPES = ['https://www.googleapis.com/auth/spreadsheets', 'https://www.googleapis.com/auth/drive']
  flow = InstalledAppFlow.from_client_secrets_file(
      'client_secret.json', SCOPES, redirect_uri='https://colab.research.google.com/'
  )
  creds = flow.run_local_server(port=0)
  

三、Google Workspace 密钥逻辑答疑 #

• Service Account模式：密钥逻辑就是加载下载的JSON文件生成凭证，示例代码：

  from google.oauth2 import service_account
  import gspread
  
  SCOPES = ['https://www.googleapis.com/auth/spreadsheets', 'https://www.googleapis.com/auth/drive']
  creds = service_account.Credentials.from_service_account_file(
      'your-service-account-key.json', scopes=SCOPES
  )
  gc = gspread.authorize(creds)
  

• OAuth模式：密钥逻辑是加载OAuth Client ID的JSON文件（client_secret.json），通过用户授权流程获取临时凭证，不需要长期密钥，属于用户授权模式。
• 若要访问Google Workspace域内资源，需给Service Account开启域范围委派：在Google Cloud Console的Service Account详情页启用该功能，再到Workspace管理控制台的API权限中，为这个Service Account授权对应的Scopes，才能访问域内用户的表格资源。

内容的提问来源于stack exchange，提问作者Viet Nguyen