示例

本部分提供了一个 codelab，您可以通过它熟悉 Google Sheets API。此外，本页还提供了一组“配方”示例，演示了如何将预期的 Google 表格操作转换为 API 请求。

通常，您可以通过多种方式使用该 API 完成给定的任务。在决定如何处理任务时，请注意以下事项：

• 如果您需要读取或写入单元格值，最好使用 spreadsheets.values 集合，而不是 spreadsheets 集合。对于简单的读取/写入操作，前者更易于使用。

• 尽可能使用批处理方法（spreadsheet.batchUpdate、spreadsheet.values.batchGet 和 spreadsheet.values.batchUpdate）将多个请求捆绑到单个方法调用中。使用这些批量方法可提高效率，因为它们：

  • 减少客户端 HTTP 开销。
  • 减少查询次数。
  • 减少文档的修订次数。
  • 确保批处理中所有更改的原子性。

食谱

本部分列出的示例演示了如何将 Google 表格中的常见操作表示为 Sheets API v4 请求。

这些示例以 HTTP 请求的形式呈现，不涉及具体语言。如需了解如何使用 Google API 客户端库以特定语言实现 Sheets API 请求协议，请参阅读取和写入单元格值和更新电子表格指南。

本部分中的食谱分为以下几类：

• 基本读取 - 显示如何从工作表中读取值的配方。
• 基本写入 - 显示如何将值写入工作表的配方。
• 基本格式设置 - 展示如何更改工作表和单元格外观的方案。
• 图表 - 显示如何在工作表中创建和更改图表的配方。
• 条件格式 - 显示如何根据条件更改单元格外观的配方。
• 数据操作 - 显示如何在电子表格中创建、移动和操控数据的配方。
• 命名范围和受保护的范围 - 演示如何在电子表格中创建、更新和移除命名范围和受保护的范围的配方。
• 数据透视表 - 演示如何在工作表中创建数据透视表的配方。
• 行和列操作 - 显示如何添加、移除和移动行和列，以及如何更新其属性的配方。
• 工作表操作 - 显示如何创建、清除、复制和删除工作表以及如何控制其属性的配方。