Google Sheets API 概览

Google Sheets API 是一个 RESTful 接口，您可以通过该接口读取和修改 电子表格的数据。此 API 最常见的用途包括： 任务：

  • 创建电子表格
  • 读取和写入电子表格单元格值
  • 更新电子表格格式
  • 管理关联工作表

下面列出了此 API 中使用的常用术语：

电子表格

Google 表格中可包含多个工作表的主要对象，每个工作表 以及单元格中包含的结构化信息。Spreadsheet resource 表示每个 每个电子表格都有一个 值 spreadsheetId， 包含字母、数字、连字符或下划线。您可以 Google 表格网址中的电子表格 ID：

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

表格

电子表格中的页面或标签页。Sheet resource 代表每一个 并且每个工作表都有唯一的标题和数字 sheetId 值。您 可以在 Google 表格网址中找到工作表 ID：

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

单元格

工作表中的单个文本字段或数据。单元格按行排列 和列，还可按单元格范围分组。CellData resource 代表每一个 单元格，但它没有唯一 ID 值。而是使用行和列 坐标标识细胞。

A1 表示法
一种语法，用于定义包含字符串的单元格或单元格范围 包含工作表名称以及使用 列字母和行号。这种方法最常用，也最实用， 。

显示具体示例

  • Sheet1!A1:B2 引用 Sheet1 前两行和前两行中的所有单元格。
  • Sheet1!A:A 引用 Sheet1 第一列中的所有单元格。
  • Sheet1!1:2 引用 Sheet1 前两行中的所有单元格。
  • Sheet1!A5:A 是指工作表 1 中第一列从第 5 行开始的所有单元格。
  • A1:B2 是指第一个可见工作表前两行和前两行中的所有单元格。
  • Sheet1 引用 Sheet1 中的所有单元格。
  • 'Jon's_Data'!A1:D5 是指名为“Jon's_Data”的工作表前五行四列中的所有单元格。
  • 'My Custom Sheet'!A:A 是指名为“My Custom Sheet”（我的自定义工作表）的工作表第一列中的所有单元格。
  • 'My Custom Sheet' 引用“我的自定义工作表”中的所有单元格。

如果工作表名称包含空格、特殊字符或字母数字字符组合，则必须使用单引号。

提示：请尽可能为电子表格中的对象使用不同的名称。例如，A1 是指第一个可见工作表中的单元格 A1，而 A1 是指名为“A1”的工作表中的所有单元格。同样，Sheet1 引用 Sheet1 中的所有单元格。但是，如果有一个名为“Sheet1”的命名范围，则 Sheet1 会引用该命名范围，而 Sheet1 会引用该工作表。
R1C1 表示法
一种语法，用于定义包含字符串的单元格或单元格范围 包含工作表名称以及使用 行号和列号这种方法不如 A1 表示法常见 但当引用的单元格范围相对于给定值时可能会非常有用 单元格的位置。

显示具体示例

  • Sheet1!R1C1:R2C2 是指 Sheet1 前两行中的前两个单元格。
  • R1C1:R2C2 是指第一个可见工作表前两行中的前两个单元格。
  • Sheet1!R[3]C[1] 是指当前单元格下方三行、右列一列的单元格。
命名的范围
已定义的单元格或包含自定义名称的单元格范围（简化版） 所有引用FilterView 资源 代表命名的范围。
受保护的范围
已定义的无法修改的单元格或单元格范围。答 ProtectedRange 资源 表示受保护的范围。

  • 了解如何使用 Google Workspace API 进行开发，包括如何处理 身份验证和授权，请参阅开发 Google Workspace。

  • 如需了解如何配置和运行 Sheets API 应用，请参阅 快速入门概览。