Google Sheets API 概览

Google Sheets API 是一个 RESTful 接口,可用于读取和修改电子表格的数据。此 API 最常见的用途包括以下任务:

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

下面列出了 Sheets 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”的第一列中的所有单元格。如果工作表名称中包含空格、特殊字符或字母数字组合,则必须输入单引号。
  • '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 资源表示受保护的范围。

后续步骤