Google Sheets API 是符合 REST 樣式的介面,可讓您讀取及修改試算表資料。這個 API 最常見的用途包括以下工作:
- 建立試算表
- 讀取及寫入試算表儲存格的值
- 更新試算表格式
- 管理連結試算表
以下是 Sheets 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
是指工作表 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]
參照的儲存格是下方三列,右側是目前儲存格右側一欄。
- 已命名範圍
已定義的儲存格或儲存格範圍,具有自訂名稱,可簡化整個應用程式的參照。FilterView 資源代表已命名的範圍。
- 保護範圍
無法修改定義的儲存格或儲存格範圍。ProtectedRange 資源代表受保護的範圍。
後續步驟
如要瞭解如何使用 Google Workspace API 進行開發,包括處理驗證與授權,請參閱「在 Google Workspace 上開發」。
如要瞭解如何設定及執行簡單的 Sheets API 應用程式,請參閱快速入門導覽課程總覽。