範例

本節提供程式碼研究室，可用於熟悉 Google 試算表 API。另提供一組「食譜」範例，示範如何將預期的 Google 試算表動作轉譯為 API 要求。

通常可以透過多種方式使用 API 完成指定工作。在決定如何完成任務時，請注意下列事項：

• 如果您需要讀取或寫入儲存格值，spreadsheets.values 集合比 spreadsheets 集合更適合。表單的介面更容易用於簡單的讀取/寫入作業。

• 請盡可能使用批次方法 (spreadsheet.batchUpdate、spreadsheet.values.batchGet 和 spreadsheet.values.batchUpdate)，將多個要求組合成單一方法呼叫。使用這些批次方法可以提升效率：

  • 降低用戶端 HTTP 負擔。
  • 減少查詢次數。
  • 減少文件的修訂版本數量。
  • 確保批次中所有變更都具備單元性。

套件

本節列出的範例說明如何以試算表 API v4 要求的形式，以試算表中的常見動作表示。

這些範例是以 HTTP 要求形式呈現，採用不受語言限制。如要瞭解如何使用 Google API 用戶端程式庫以特定語言實作試算表 API 要求通訊協定，請參閱讀取及寫入儲存格值和更新試算表指南。

這個部分的食譜分為以下類別：

• 基本讀取 - 說明如何讀取工作表中的值的方案。
• 基本寫入：說明如何將值寫入工作表的方案。
• 基本格式設定 - 示範如何變更工作表與儲存格外觀的方案。
• 圖表 - 說明如何在工作表中建立及修改圖表的方案。
• 條件式格式設定：說明如何根據條件修改儲存格外觀的食譜。
• 資料作業：說明如何在試算表中建立、移動及操控資料的方案。
• 已命名和受保護的範圍 - 說明如何在試算表中建立、更新及移除已命名和受保護的範圍。
• 資料透視表 - 說明如何在工作表中建立資料透視表的食譜。
• 資料列與資料欄作業 - 說明如何新增、移除及移動資料列和資料欄，以及更新其屬性的方案。
• 工作表作業：示範如何建立、清除、複製及刪除工作表，以及控管工作表屬性的方案。