Google Sheets API 總覽

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

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

以下是試算表 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 是指 Sheet1 前兩列的前兩個儲存格。
  • Sheet1!A:A 是指 Sheet1 第一欄的所有儲存格。
  • Sheet1!1:2 是指 Sheet1 前兩列的所有儲存格。
  • Sheet1!A5:A 是指工作表 1 第一欄從第 5 列開始的所有儲存格。
  • A1:B2 是指第一個可見工作表的前兩列的前兩個儲存格。
  • Sheet1 是指 Sheet1 中的所有儲存格。
  • 'My Custom Sheet'!A:A 是指工作表「我的自訂試算表」中第一欄的所有儲存格。工作表名稱含有空格、特殊字元或英數字元組合時,必須使用單引號。
  • 'My Custom Sheet' 是指「我的自訂工作表」中的所有儲存格。

提示:請盡可能在試算表中使用不同的物件名稱。舉例來說,A1 是指第一個可見工作表中的儲存格 A1,「A1」則是指工作表 A1 中所有儲存格。同樣地,Sheet1 是指 Sheet1 中的所有儲存格。不過,如果有名為「Sheet1」的已命名範圍,Sheet1 就會參照已命名範圍,而「Sheet1」則是指工作表。

R1C1 標記法

這種語法使用字串定義儲存格或儲存格範圍,字串中包含工作表名稱,再加上使用列號和欄號開始和結束儲存格座標。這個方法較不常見,但對於參照指定儲存格位置的儲存格範圍而言,相當實用。

查看範例

  • Sheet1!R1C1:R2C2 是指 Sheet1 前兩列的前兩個儲存格。
  • R1C1:R2C2 是指第一個可見工作表的前兩列的前兩個儲存格。
  • Sheet1!R[3]C[1] 指的是位於目前儲存格下方三列和另一欄的儲存格。
已命名範圍

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

保護範圍

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

後續步驟