为何Google服务账户可访问自建表格，却无法访问共享表格？

以下是可能导致服务账户无法访问共享Google Sheet的常见原因及对应解决方法：

• 确认共享权限的有效性

  • 必须直接添加服务账户的完整邮箱地址（格式：xxx@xxx.iam.gserviceaccount.com）作为共享对象，避免通过组或间接方式共享，否则权限可能无法正确映射。
  • 确保授予的权限级别至少为「编辑」，部分场景下「查看者」权限也会导致文件不可见（尤其是跨Workspace共享时）。
  • 耐心等待1-2分钟权限同步：Google的权限系统存在延迟，跨账户或跨组织的共享可能需要更长时间生效。

• 核对Sheet ID的准确性

  • 从目标表格的浏览器地址栏提取正确的Sheet ID（即https://docs.google.com/spreadsheets/d/[SHEET_ID]/edit中/d/和/edit之间的字符串），确保代码中使用的ID完全一致，避免误传文件夹ID或字符遗漏。

• 验证服务账户的API访问范围

  • 检查代码中服务账户的凭据是否包含必要的API范围：https://www.googleapis.com/auth/spreadsheets（操作表格内容）和https://www.googleapis.com/auth/drive（访问Drive中的文件），缺少任意一个都可能导致文件无法被识别。
  • 若修改过API范围，需重新生成服务账户密钥并更新代码中的凭据，旧密钥不会自动应用新的范围设置。

• 通过Drive API确认文件可见性

  • 调用Drive API的files.list接口，验证服务账户能否搜索到目标表格：

    from googleapiclient.discovery import build
    
    # 假设credentials是已初始化的服务账户凭据
    drive_service = build('drive', 'v3', credentials=credentials)
    search_result = drive_service.files().list(
        q="name='你的表格名称'",
        fields="files(id, name)"
    ).execute()
    print("搜索到的文件：", search_result.get('files', []))
    

  • 如果搜索结果为空，说明权限未生效；若能搜索到，再排查Sheets API的调用逻辑是否存在参数错误。

• 排查Workspace组织限制

  • 若共享表格属于Google Workspace账户，联系管理员确认是否存在外部共享限制政策：比如禁止将内部文件共享给外部服务账户，或需要管理员审批此类共享请求。

• 检查表格状态与父文件夹权限

  • 确认目标表格未被删除、归档，或移动到服务账户无权访问的父文件夹中（即使表格本身被共享，父文件夹权限不足也会导致服务账户无法定位到文件）。
  • 若表格经历过所有权转移，确保转移流程已完成，权限同步到位。

内容的提问来源于stack exchange，提问作者Jason Dilworth