Google 表格 API 是一个 RESTful 接口,可让您读取和修改电子表格的数据。此 API 最常见的用途包括以下任务:
- 创建电子表格
- 读取和写入电子表格单元格的值
- 更新电子表格格式
- 管理关联工作表
下面列出了表格 API 中使用的常用术语:
- 电子表格
Google 表格中可以包含多个工作表的主要对象,每个工作表的单元格都包含结构化信息。电子表格资源代表每个电子表格,具有唯一的
spreadsheetId
值,其中包含字母、数字、连字符或下划线。您可以在 Google 表格网址中找到电子表格 ID:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- 工作表
电子表格中的页面或标签页。表格资源表示每个工作表,具有唯一的标题和数字
sheetId
值。您可以在 Google 表格网址中找到工作表 ID:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- 单元格
工作表中的单个文本字段或数据字段。单元格按行和列排列,并且可以作为单元格范围分组。CellData 资源表示每个单元格,但不具有唯一的 ID 值。相反,行坐标和列坐标用于标识单元格。
- A1 表示法
一种语法,用于定义使用字符串定义单元格或单元格范围的语法。该字符串包含工作表名称,以及使用列字母和行号的起始和结束单元格坐标。引用单元格的绝对范围时,此方法最常见且最有用。
显示示例
Sheet1!A1:B2
是指 Sheet1 前两行的前两个单元格。Sheet1!A:A
是指 Sheet1 第一列中的所有单元格。Sheet1!1:2
是指 Sheet1 前两行中的所有单元格。Sheet1!A5:A
是指工作表 1 第一列(从第 5 行开始)的所有单元格。A1:B2
是指第一个可见工作表前两行的前两个单元格。Sheet1
引用了 Sheet1 中的所有单元格。'My Custom Sheet'!A:A
会引用名为“我的自定义工作表”的工作表第一列中的所有单元格。如果工作表名称中包含空格、特殊字符或字母数字字符组合,则必须使用英文单引号。'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 上开发。
如需了解如何配置和运行简单的表格 API 应用,请参阅快速入门概览。