如何通过API打开并编辑Google Sheet？

架构老林

2026-8-2

解决方案：使用Google Sheets API而非网页版编辑链接

直接请求/edit网页链接的方式不可行——该链接是为浏览器渲染设计的，返回的HTML需要加载Google托管的额外CSS/JS资源才能完整显示，且这种方式不属于官方API调用规范，无法稳定用于应用集成。

正确的做法是使用Google Sheets API，这是Google官方提供的程序化操作表格的接口，完全适配服务端/应用场景，无需依赖前端资源，直接通过access_token鉴权即可完成所有读写编辑操作。

关键操作要点

权限验证：确保你的access_token已申请https://www.googleapis.com/auth/spreadsheets（读写权限）或https://www.googleapis.com/auth/spreadsheets.readonly（只读权限）范围，这是调用Sheets API的前提。
核心API调用示例：
- 读取表格数据：
  发送GET请求到https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}，请求头携带Authorization: Bearer {access_token}。返回的是结构化JSON数据，可直接解析处理。
- 写入/修改数据：
  发送PUT请求到上述相同端点，请求头除Authorization外，需添加Content-Type: application/json，请求体格式示例：
```
{
  "range": "Sheet1!A1:B2",
  "values": [
    ["数据1", "数据2"],
    ["数据3", "数据4"]
  ]
}
```
UI展示方案：如果需要在应用中展示表格内容，不要尝试渲染Google的HTML页面，而是通过Sheets API获取数据后自行构建前端UI（比如用表格组件渲染），这样完全可控，也避免了依赖第三方资源的问题。