Method: presentations.batchUpdate

為簡報套用一或多項更新。

每個 request 都會在套用前進行驗證。如果任何要求無效，整個要求都會失敗，且不會套用任何內容。

部分要求會提供 replies，讓您瞭解這些要求的應用方式。其他要求則不需要傳回資訊，而是會傳回空白回覆。回覆的順序與要求的順序相符。

舉例來說，假設您呼叫 batchUpdate 時傳入四個更新項目，但只有第三個會傳回資訊。回應會包含兩個空白回覆：回覆第三個要求，以及另一個空白回覆。

由於其他使用者可能會編輯簡報，因此簡報可能不會完全反映您的變更：您的變更可能會因協作者的變更而有所改變。如果沒有協作者，簡報應會反映你的變更。無論如何，我們都會保證要求中的更新會以不可分割的方式一併套用。

HTTP 要求

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

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

路徑參數

參數
presentationId

string

要套用更新的簡報。

要求主體

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

JSON 表示法 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
欄位
requests[]

object (Request)

要套用至簡報的更新清單。
writeControl

object (WriteControl)

提供寫入要求的執行方式控管功能。

回應主體

批次更新的回應訊息。

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

JSON 表示法 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
欄位
presentationId

string

套用更新的簡報。
replies[]

object (Response)

更新的回覆。這會與更新項目一對一對應，但某些要求的回覆可能會為空白。
writeControl

object (WriteControl)

套用要求後的更新寫入控制項。

授權範圍

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

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

詳情請參閱授權指南。

WriteControl

提供寫入要求的執行方式控制項。

JSON 表示法 
{
  "requiredRevisionId": string
}
欄位
requiredRevisionId

string

寫入要求所需的呈現方式 revision ID。如果指定的必要修訂版本 ID 與簡報的目前修訂版本 ID 不符，系統就不會處理要求，並傳回 400 無效要求錯誤。

回應中傳回的必要修訂版本 ID 會指出要求套用後的文件修訂版本 ID。