示例

本部分将介绍您可以用来熟悉 Sheets API 的代码实验室, 还将提供一组“诀窍”示例,这些示例演示了如何将计划的表格操作转换为 API 请求的“诀窍”示例。

很多情况下,使用 API 完成给定任务的方法不止一种。 在确定如何完成任务时,请谨记以下几点:

  • 如果您只需要读取或写入单元格值,spreadsheets.values 集合要优于 spreadsheets 集合。 对于简单的读取/写入操作来说,前者的接口更易于使用。
  • 如果可能,请使用批处理方法(spreadsheet.batchUpdatespreadsheet.values.batchGetspreadsheet.values.batchUpdate)将多个请求捆绑到一个方法调用中。使用这些批处理方法可以提高效率;它们可以减少客户端 HTTP 开销、减少查询次数、减少文档的修订次数,以及确保批次中所有更改的原子性。

诀窍

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

为保证语言中立性,这些示例以 HTTP 请求的形式呈现。 要了解如何使用 Google API 客户端内容库以特定语言实现 Sheets API 请求协议,请参阅读取和写入值指南和更新电子表格指南。

此部分中的诀窍分为以下类别:

  • 基本读取 — 这些诀窍介绍了从工作表读取值的最直接方式。
  • 基本写入 — 这些诀窍介绍了向工作表写入值的最直接方式。
  • 基本格式化 — 这些诀窍介绍了如何更改工作表和单元格的外观。
  • 图表 — 这些诀窍介绍了如何在工作表中创建和更改图表。
  • 条件格式化 — 这些诀窍介绍了如何根据条件更改单元格外观。
  • 数据操作 — 这些诀窍介绍了如何在电子表格中创建、移动和操作数据。
  • 命名和保护范围 — 这些诀窍介绍了如何在电子表格中创建、更新和移除命名和保护范围。
  • 数据透视表 — 这些诀窍介绍了如何在工作表中创建数据透视表。
  • 行和列操作 — 这些诀窍介绍了如何添加、移除和移动行和列,以及如何更新它们的属性。
  • 工作表操作 — 这些诀窍介绍了如何在电子表格中创建、删除和更新工作表属性。