示例

本部分将介绍一个 Codelab,您可以通过该 Codelab 来熟悉 Google Tables API。此外,我们还提供一组“配方”示例,演示了如何将预期的 Google 表格操作转换为 API 请求。

使用 API 完成给定任务的方式通常不止一种。在决定如何处理任务时,请注意以下几点:

  • 如果您需要读取或写入单元格值,spreadsheets.values 集合比 spreadsheets 集合是更好的选择。对于简单的读取/写入操作来说,前者的接口更易于使用。
  • 尽可能使用批处理方法(spreadsheet.batchUpdatespreadsheet.values.batchGetspreadsheet.values.batchUpdate)将多个请求捆绑到单个方法调用中。使用这些批处理方法可以提高效率,因为它们:

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

Recipes

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

出于中性考虑,这些示例以 HTTP 请求的形式呈现。如需了解如何使用 Google API 客户端库以特定语言实现 Tables API 请求协议,请参阅读取和写入单元格值更新电子表格指南。

此部分中的方案分为以下几类:

  • 基本读取 - 这些诀窍介绍了如何从工作表中读取值。
  • 基本写入 - 这些诀窍介绍了如何向工作表写入值。
  • 基本格式 - 演示如何更改工作表和单元格外观的诀窍。
  • 图表 - 这些诀窍介绍了如何在工作表中创建和更改图表。
  • 条件格式 - 这些诀窍介绍了如何根据条件更改单元格外观。
  • 数据操作 - 这些诀窍介绍了如何在电子表格中创建、移动和处理数据。
  • 已命名和受保护的范围 - 这些诀窍介绍了如何在电子表格中创建、更新和移除已命名和受保护的范围。
  • 数据透视表 - 此诀窍介绍了如何在工作表中创建数据透视表。
  • 行和列操作 - 这些诀窍介绍了如何添加、移除和移动行和列,以及如何更新行和列的属性。
  • 工作表操作 - 这些诀窍介绍了如何创建、清除、复制和删除工作表,以及如何控制工作表的属性。