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' 引用了“我的自定义工作表”中的所有单元格。

提示：在电子表格中，对于这些对象，请尽可能使用不同的名称。例如，A1 是指第一个可见工作表中的单元格 A1，而“A1”则表示工作表中名为 A1 的所有单元格。同样，Sheet1 会引用 Sheet1 中的所有单元格。但如果存在标题为“Sheet1”的命名范围，则“Sheet1”会引用已命名的范围，“Sheet1”会引用相应工作表。
R1C1 表示法

一种语法，用于定义一个单元格或单元格范围，其中的字符串包含工作表名称以及使用行号和列号的起始和结束单元格坐标。此方法不如 A1 表示法常见，但在引用相对于给定单元格位置的单元格范围时很有用。

显示示例

  • Sheet1!R1C1:R2C2 是指 Sheet1 前两行中的前两个单元格。
  • R1C1:R2C2 是指第一个可见工作表前两行中的前两个单元格。
  • Sheet1!R[3]C[1] 是指当前单元格下方三行、右侧一列的单元格。
命名的范围

使用自定义名称定义的单元格或单元格范围，可简化整个应用中的引用。FilterView 资源表示已命名的范围。

受保护的范围

已定义的不可修改的单元格或单元格范围。ProtectedRange 资源表示受保护的范围。

后续步骤