Google Sheets API 總覽

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

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

以下是 Sheets API 的常見詞彙：

試算表

Google 試算表的主要物件可含有多份工作表 包含儲存格中的結構化資訊A 罩杯 試算表資源代表所有試算表，並有 專屬 spreadsheetId 值， ，其中包含英文字母、數字、連字號或底線。您可以在 以下為 Google 試算表網址中的試算表 ID：

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

工作表

試算表內的網頁或分頁。A 罩杯 試算表資源代表了每一份工作表， 不重複的名稱和數字 sheetId 值。個人中心 可以在 Google 試算表網址中找到工作表 ID：

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

儲存格

工作表中的個別文字欄位或資料欄位。儲存格排列依據 資料列和資料欄，且可分組為儲存格範圍。A 罩杯 「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] 參照的儲存格是下方三列，右側是目前儲存格右側一欄。
已命名範圍

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

保護範圍

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

後續步驟