Google Sheets API 總覽

Google Sheets API 是符合 REST 樣式的介面，可讓您讀取及修改試算表資料。這個 API 最常見的用途包括以下工作：

  • 建立試算表
  • 讀取及寫入試算表儲存格的值
  • 更新試算表格式
  • 管理連結試算表

以下是 Sheets API 的常見詞彙：

試算表

Google 試算表中的主要物件可包含多份工作表，每個工作表的儲存格都包含結構化資訊。試算表資源代表每份試算表，且有專屬的 spreadsheetId 值，可使用英文字母、數字、連字號或底線。您可以在 Google 試算表網址中找到試算表 ID：

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

工作表

試算表內的網頁或分頁。試算表資源代表每一份工作表，具有不重複的標題和 sheetId 數值。您可以在 Google 試算表網址中找到工作表 ID：

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

儲存格

工作表中的個別文字欄位或資料欄位。儲存格會以資料列和資料欄排列，且可以按照儲存格範圍分組。CellData 資源代表每個儲存格，但沒有專屬 ID 值。請改為使用列與欄座標來識別儲存格。

A1 標記法

一種語法，可透過包含工作表名稱的字串，以及起始和結尾儲存格座標 (利用欄字母和資料列編號) 定義儲存格或儲存格範圍。這個方法在參照絕對儲存格範圍時最常見也最實用。

顯示範例
  • Sheet1!A1:B2 是指工作表 1 中前兩列的前兩個儲存格。
  • Sheet1!A:A 參照工作表 1 第一欄中的所有儲存格。
  • Sheet1!1:2 參照 Sheet1 中前兩列的所有儲存格。
  • Sheet1!A5:A 參照工作表 1 第一欄從第 5 列起的所有儲存格。
  • A1:B2 是指第一個顯示工作表中，前兩列的前兩個儲存格。
  • Sheet1 參照工作表 1 中的所有儲存格。
  • 'My Custom Sheet'!A:A 指的是工作表「我的自訂工作表」中第一欄的所有儲存格。如果工作表名稱含有空格、特殊字元或英數字元組合，則必須使用單引號。
  • 'My Custom Sheet' 參照「我的自訂工作表」中的所有儲存格。

提示：請盡可能為試算表中的物件使用不重複的名稱。例如，A1 是指第一個可見工作表中的儲存格 A1，而「A1」則是指工作表 A1 中的所有儲存格。同樣地，Sheet1 則參照工作表 1 中的所有儲存格。不過，如果有名為「Sheet1」的已命名範圍，則 Sheet1 是指已命名的範圍，「Sheet1」則是指工作表。
R1C1 標記法

一種語法，可透過包含工作表名稱的字串，以及起始和結束儲存格座標 (如資料列編號和欄號) 定義儲存格或儲存格範圍。這個方法比 A1 標記法較不常見，但在參照與指定儲存格位置相關的儲存格範圍時，這個方法就很有用。

顯示範例
  • Sheet1!R1C1:R2C2 是指工作表 1 中前兩列的前兩個儲存格。
  • R1C1:R2C2 是指第一個顯示工作表中，前兩列的前兩個儲存格。
  • Sheet1!R[3]C[1] 參照的儲存格是下方三列，右側是目前儲存格右側一欄。
已命名範圍

已定義的儲存格或儲存格範圍，具有自訂名稱，可簡化整個應用程式的參照。FilterView 資源代表已命名的範圍。

保護範圍

無法修改定義的儲存格或儲存格範圍。ProtectedRange 資源代表受保護的範圍。

後續步驟