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 資源代表受保護的範圍。