範例

本節將介紹程式碼研究室，讓您熟悉 Google 試算表 API。我們也提供一組「食譜」範例，說明如何將指定的 Google 試算表動作轉譯為 API 要求。

使用 API 完成特定工作時，通常有多種方法可供選擇。決定如何處理工作時，請注意下列事項：

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

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

  • 減少用戶端 HTTP 額外負擔。
  • 減少查詢數量。
  • 減少文件的修訂版本數量。
  • 確保批次中的所有變更皆為不可分割。

食譜

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

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

本節的食譜分為以下類別：

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