本節將介紹程式碼研究室,讓您熟悉 Google 試算表 API。我們也提供一組「食譜」範例,說明如何將指定的 Google 試算表動作轉譯為 API 要求。
使用 API 完成特定工作的方式通常不只一種。決定如何處理工作時,請注意下列事項:
- 如果您需要讀取或寫入儲存格值,
spreadsheets.values
集合比spreadsheets
集合更適合。對於簡單的讀/寫作業,前者的介面更容易使用。 請盡可能使用批次方法 (
spreadsheet.batchUpdate
、spreadsheet.values.batchGet
和spreadsheet.values.batchUpdate
),將多個要求合併為單一方法呼叫。使用這些批次方法可提高效率,因為這些方法可:- 減少用戶端 HTTP 額外負擔。
- 減少查詢數量。
- 減少文件的修訂版本數量。
- 確保批次中所有變更的不可分割性。
食譜
本節列出的範例說明如何以 Sheets API v4 要求在 Google 試算表中表示常用動作。
這些範例以 HTTP 要求的形式呈現,可達成語言中立的目標。如要瞭解如何使用 Google API 用戶端程式庫,以特定語言實作 Sheets API 要求通訊協定,請參閱「讀取及寫入儲存格值」和「更新試算表」指南。
本節的食譜分為以下類別:
- 基本讀取 - 說明如何從工作表讀取值的食譜。
- 基本寫入:示範如何將值寫入工作表的食譜。
- 基本格式:顯示如何變更工作表與儲存格外觀的食譜。
- 圖表:說明如何在試算單中建立及變更圖表的秘訣。
- 條件式格式設定:顯示如何根據條件變更儲存格外觀的食譜。
- 資料操作:說明如何在試算表中建立、移動及操作資料的秘訣。
- 命名及受保護的範圍:這類食譜會說明如何在試算表中建立、更新及移除命名及受保護的範圍。
- 資料透視表:說明如何在工作表中建立資料透視表的秘訣。
- 資料列與資料欄作業:說明如何新增、移除及移動資料列和資料欄,以及更新資料列和資料欄的食譜。
- 工作表作業:說明如何建立、清除、複製及刪除工作表,以及控制其屬性的食譜。