Google Sheets API 總覽

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

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

以下是此 API 中使用的常見詞彙清單：

試算表

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

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

工作表

試算表內的網頁或分頁。Sheet 資源代表 而且具有不重複的標題和數字 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 參照工作表 1 第一欄中的所有儲存格。
  • Sheet1!1:2 參照 Sheet1 中前兩列的所有儲存格。
  • Sheet1!A5:A 參照工作表 1 第一欄從第 5 列起的所有儲存格。
  • A1:B2 參照第一個顯示工作表中前兩列和前兩欄的所有儲存格。
  • Sheet1 參照工作表 1 中的所有儲存格。
  • 'Jon's_Data'!A1:D5 指的是工作表「Jon's_Data」中前 5 列和前 4 欄的所有儲存格。
  • '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 資源 代表已命名範圍
保護範圍
已定義的儲存格或儲存格範圍無法修改。A 罩杯 ProtectedRange 資源 代表受保護的範圍