Google Sheets API 總覽

Google 試算表 API 是符合 REST 樣式的介面，可讓您讀取及修改試算表資料。Sheets API 可讓您：

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

以下列出 Sheets API 中常用的術語：

試算表

Google 試算表的主要物件。可包含多個 Sheets，每個 Sheets 都包含 Cells 中的結構化資訊。spreadsheets 資源代表試算表。其中包含不重複的 spreadsheetId 值。

試算表 ID
試算表的專屬 ID。這是一個包含英文字母、數字和一些特殊字元的特定字串，用於參照試算表，可從試算表的網址衍生而來。即使試算表名稱有所變更，試算表 ID 仍會保持不變。
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
試算表

試算表中的頁面或分頁。Sheets 資源代表試算表。其中包含不重複的數值 sheetId 值和工作表 title，做為 SheetProperties 物件的一部分。

工作表 ID
試算表中特定工作表的專屬 ID。這是一個包含英文字母、數字和一些特殊字元的特定字串，可用來參照試算表，並可從試算表的網址衍生而來。即使試算表名稱有所變更，試算表 ID 仍會保持不變。如需範例，請參閱「試算表 ID」。
儲存格

試算表中的個別文字或資料欄位。儲存格會以列和欄排列，並可分組為儲存格範圍。Cells 資源代表每個單元格，但沒有專屬 ID 值。而是使用儲存格的列和欄座標來識別。

A1 符號
這個語法可用來定義單一儲存格或儲存格範圍，其中字串包含工作表名稱，以及使用資料欄英文字母和列號的起始和結束儲存格座標。在參照絕對儲存格範圍時，這個方法是最常見且實用的做法。

顯示範例

  • Sheet1!A1:B2 會參照工作表 1 中前兩列和資料欄的所有儲存格。
  • Sheet1!A:A 會參照工作表 1 第一欄中的所有儲存格。
  • Sheet1!1:2 會參照工作表 1 前兩列的所有儲存格。
  • Sheet1!A5:A 是指工作表 1 第一欄的所有儲存格，從第 5 列開始。
  • A1:B2 是指第一個可見工作表前兩列和欄中的所有儲存格。
  • Sheet1 會參照工作表 1 中的所有儲存格。
  • 'Jon's_Data'!A1:D5 是指名為「Jon's_Data」的工作表中前五列和四欄的所有儲存格。
  • 'My Custom Sheet'!A:A 是指名為「My Custom Sheet」工作表第一欄中的所有儲存格。
  • 'My Custom Sheet' 是指「我的自訂工作表」中的所有儲存格。

含有空格、特殊字元或英數字元組合的活頁名稱必須使用單引號。

提示：請盡可能為試算表中的物件使用不重複的名稱。舉例來說，A1 (不含引號) 是指第一個可見工作表中的儲存格 A1。'A1' 是指名為 A1 的工作表。同樣地，Sheet1 會參照名稱為 Sheet1 的工作表。不過，如果有一個名為「工作表 1」的命名範圍，則「工作表 1」是指命名範圍，而 'Sheet1' 則是指工作表。
R1C1 標記法
這個語法可用來定義單一儲存格或儲存格範圍，其中字串包含工作表名稱，以及使用列號和欄號的起始和結束儲存格座標。這個方法不如 A1 符號常見，但在參照相對於特定儲存格位置的儲存格範圍時，可能會很實用。

顯示範例

  • Sheet1!R1C1:R2C2 是指工作表 1 前兩列中的前兩個儲存格。
  • R1C1:R2C2 是指第一個可見工作表前兩列中的前兩個儲存格。
  • Sheet1!R[3]C[1] 是指目前儲存格下方三列、右側一欄的儲存格。
已命名範圍
已定義的儲存格或儲存格範圍，並使用自訂名稱，以便簡化應用程式中的參照。FilterView 資源代表命名範圍。
受保護的範圍
已定義的儲存格或無法修改的儲存格範圍。ProtectedRange 資源代表受保護的範圍。