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
資源代表受保護的範圍。
相關主題
如要瞭解如何使用 Google Workspace API 進行開發,包括處理驗證與授權,請參閱「在 Google Workspace 上開發」。
如要瞭解如何設定及執行 Google 試算表 API 應用程式,請試試 JavaScript 快速入門。