範例

本節提供codelab，可協助您熟悉 Google Sheets API。此外，我們也提供一系列「配方」範例，說明如何將預期的 Google 試算表動作轉換為 API 要求。

通常，您可以使用 API 完成特定工作的方式不只一種。決定如何處理工作時，請注意下列事項：

• 如要讀取或寫入儲存格值，建議使用 spreadsheets.values 集合，而非 spreadsheets 集合。前者的介面較易於使用，適合簡單的讀取/寫入作業。

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

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

食譜

本節列出的範例會示範如何以 Sheets API v4 要求表示 Google 試算表中的常見動作。

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

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

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