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