除了儲存格所含的值資料外, 試算表包含許多其他類型的資料 資料,例如:
- 尺寸
- 儲存格格式和框線
- 已命名範圍
- 受保護的範圍
- 條件式格式設定
這些是許多資料架構
就會對試算表執行任務spreadsheets.batchUpdate
方法可讓您
請更新任一試算表詳細資料所有變更都會按批次處理
一個要求失敗時,也沒有其他要求 (可能相依)
並寫入變更
本頁將說明使用
spreadsheets.batchUpdate
方法。如果您需要讀取及寫入儲存格值資料,也可以使用
spreadsheets.values
「讀取及寫入儲存格值。
作業類別
您可以將 spreadsheets.batchUpdate
支援的特定作業分組
可分為下列幾個廣泛類別:
類別 | 說明 |
---|---|
Add (和 Duplicate) | 新增物件 (或以舊物件為基礎,例如「重複要求」)。 |
Update (和「Set」) | 更新物件的某些屬性,通常單獨保留舊的屬性 (而 Set 要求會覆寫先前的資料)。 |
刪除 | 移除物件。 |
下一節會運用這些類別,說明 特定作業。
批次更新作業
spreadsheets.batchUpdate
方法的運作方式為擷取一或多個項目
要求
物件,每個物件都會指定單一種類的要求執行。另有
不同類型的要求這張圖顯示要求類型
歸入不同類別
還有其他要求會模仿使用者行為來操縱使用者動作 資料:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
限制
如要進一步瞭解 Google 試算表的儲存格和列數上限,請參閱可儲存的檔案 Google 雲端硬碟。
欄位遮罩
許多「更新」要求需要欄位遮罩這些屬性
欄位清單,以便單獨更新物件中的特定欄位
其他欄位保持不變*
的欄位遮罩被視為
萬用字元,可用來指定訊息中的每個欄位 (意即
如果未在
要求)。
如要進一步瞭解欄位遮罩,請參閱使用欄位
遮罩。
以下範例使用
UpdateSpreadsheetPropertiesRequest
只更新試算表標題:
要求:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
要求主體:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
將 TITLE 替換為試算表的新標題。
回應
更新試算表時,某些類型的要求可能會傳回回應。這些 會以陣列的形式傳回,而每個回應都擁有與 對應的要求有些要求沒有回應, 則回應空白。
通常為「add」要求所含的回應會傳回 ID 等資訊 所加入的另一個物件如需支援回應的清單,請參閱 回應。
範例
下列程式碼範例會執行這些動作:
- 使用
title
變數更新試算表標題。 - 使用
find
和replacement
變數。