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 資源代表受保護的範圍。
後續步驟
如要瞭解如何使用 Google Workspace API 進行開發,包括處理驗證和授權作業,請參閱「在 Google Workspace 上開發」一文。
如要瞭解如何設定及執行簡易試算表 API 應用程式,請參閱快速入門導覽課程總覽。