Google sheet API 概览

使用集合让一切井井有条

根据您的偏好保存内容并对其进行分类。

Google sheet API is 是一个 是一个 restful 接口，可让您读取和修改电子表格的数据。借助 sheet api，您可以 ：

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

以下是 Google 表格 API 中使用的常用术语列表：

电子表格

Google 表格中的主要对象。它可以包含多个sheet， 每个sheet 都包含Cells 中的结构化信息 。spreadsheet 资源表示电子表格。它包含一个唯一的 spreadsheetId 值。

电子表格 ID

电子表格的唯一标识符。它是一个包含字母、数字和一些特殊字符的特定字符串，用于引用电子表格，并且可以从电子表格的网址派生而来。电子表格 ID 是稳定的，即使电子表格名称发生变化也是如此。

https://docs.google.com/spreadsheet/d//edit?gid=#gid=

工作表

电子表格中的页面或标签页。sheet 资源表示工作表。它包含唯一的数字sheetId 值和工作表title，作为 SheetProperties 对象的一部分 。

工作表 ID

电子表格中特定工作表的唯一标识符。它是一个包含字母、数字和一些特殊字符的特定字符串，用于引用工作表，并且可以从电子表格的网址派生而来。工作表 ID 是稳定的，即使工作表名称发生变化也是如此。如需查看示例，请参阅电子表格 ID。

单元格

工作表中单个的文本或数据字段。单元格按行和列排列，可以作为单元格范围进行分组。Cells 资源代表每个单元格，但没有唯一的 ID 值。而是使用行和列坐标来标识单元格。

A1 表示法

一种语法，用于通过字符串定义单元格或单元格范围，其中包含表格名称以及使用列字母和行号表示的起始和结束单元格坐标。在引用绝对单元格范围时，此方法是最常用且最实用的 。

显示具体示例

• Sheet1!A1:B2 引用 Sheet1 的前两行和两列中的所有单元格。
• Sheet1!A:A 引用 Sheet1 第一列中的所有单元格。
• Sheet1!1:2 引用 Sheet1 前两行中的所有单元格。
• Sheet1!A5:A 引用 Sheet1 第一列中从第 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 资源表示受保护的范围。

如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2024-11-21。