本部分将介绍一个 Codelab,您可以通过该 Codelab 熟悉 Google 表格 API。还将提供一组“诀窍”示例,这些示例演示了如何将计划的 Google 表格操作转换为 API 请求。
使用 API 完成给定任务的方法通常不止一种。在确定如何完成任务时,请谨记以下几点:
- 如果您需要读取或写入单元格值,
spreadsheets.values
集合比spreadsheets
集合是更好的选择。旧接口更易于用于简单的读取/写入操作。 请尽可能使用批处理方法(
spreadsheet.batchUpdate
、spreadsheet.values.batchGet
和spreadsheet.values.batchUpdate
)将多个请求捆绑到一个方法调用中。使用这些批处理方法可以提高效率,因为它们具有以下特点:- 减少客户端 HTTP 开销。
- 减少发出的查询数量。
- 减少文档的修订次数。
- 确保批处理中的所有更改都是原子更改。
食谱
本部分列出的示例演示了如何以 Sheets API v4 请求表示 Google 表格中的常用操作。
为保证语言中立性,这些示例以 HTTP 请求的形式呈现。如需了解如何使用 Google API 客户端库以特定语言实现 Sheets API 请求协议,请参阅读取和写入单元格值和更新电子表格指南。
此部分中的诀窍分为以下类别:
- 基本读取 - 介绍如何从工作表读取值的食谱。
- 基本写入 - 这些食谱展示了如何向工作表写入值。
- 基本格式设置 - 这些诀窍介绍了如何更改工作表和单元格的外观。
- 图表 - 这些诀窍介绍了如何在工作表中创建和更改图表。
- 条件格式设置 - 这些诀窍介绍了如何根据条件更改单元格外观。
- 数据操作:这些诀窍介绍了如何在电子表格中创建、移动和操作数据。
- 命名和保护范围 - 这些诀窍介绍了如何在电子表格中创建、更新和移除命名和保护范围。
- 数据透视表 - 这些诀窍介绍了如何在工作表中创建数据透视表。
- 行和列操作 - 这些食谱介绍了如何添加、移除和移动行和列,以及如何更新其属性。
- 工作表操作 - 这些食谱展示了如何创建、清除、复制和删除工作表,以及如何控制其属性。