Google Sheets API 總覽

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 是指工作表 2 前兩列的前兩個儲存格。
  • Sheet1!A:A 是指工作表 1 第一欄內的所有儲存格。
  • Sheet1!1:2 是指工作表 1 前兩列的所有儲存格。
  • 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 是指工作表 2 前兩列的前兩個儲存格。
  • R1C1:R2C2 是指第一個顯示工作表前兩列的前兩個儲存格。
  • Sheet1!R[3]C[1] 指的是儲存格下方三列，以及目前儲存格右側的一欄。
已命名範圍

使用自訂名稱定義的儲存格或儲存格範圍，以簡化整個應用程式中的參照。FilterView 資源代表已命名範圍。

保護範圍

定義的儲存格或無法修改的儲存格範圍。ProtectedRange 資源代表受保護的範圍。

後續步驟