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