Method: spreadsheets.batchUpdate

對試算表套用一或多項更新。

每個 request 都會先經過驗證，才會套用。如果有任何要求無效，整個要求都會失敗，系統也不會套用任何內容。

部分要求包含 replies，瞭解要求套用方式的相關資訊。這些回覆會反映要求。舉例來說，如果您套用了 4 項更新，而第 3 人有回覆，則該回應中會有 2 個空白的回覆、實際回覆，以及另一個空白回覆。

由於試算表的協作性質，我們無法保證試算表會在完成之後準確反映變更，但是我們保證，要求中的更新資訊會統一套用。如果協作者變更的內容，你所做的變更可能會跟著改變。如果沒有協作者，試算表會反映您所做的變更。

HTTP 要求

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
spreadsheetId

string

要套用更新內容的試算表。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
欄位
requests[]

object (Request)

要套用至試算表的更新清單。系統會按照指定的順序套用要求。如果有任何要求無效，系統就不會套用任何要求。
includeSpreadsheetInResponse

boolean

決定更新回應是否應包含試算表資源。
responseRanges[]

string

限制回應試算表可涵蓋的範圍。只有在 includeSpreadsheetInResponse 為「true」時有意義。
responseIncludeGridData

boolean

如果應傳回格線資料，則為 True。只有在 includeSpreadsheetInResponse 為「true」時有意義。如果要求中有設定欄位遮罩，系統會忽略這個參數。

回應主體

批次更新試算表的回覆。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
欄位
spreadsheetId

string

套用更新的試算表。
replies[]

object (Response)

更新的回覆。這會對應更新結果的 1:1，不過部分要求的回覆可能為空白。
updatedSpreadsheet

object (Spreadsheet)

套用更新後的試算表。只有在 BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response 為 true 時才能設定。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

詳情請參閱授權指南。