Method: presentations.batchUpdate

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

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

某些要求會附上 replies,讓您瞭解套用方式的相關資訊。其他要求則不需要傳回資訊。每則回應都會傳回空白回覆回覆的順序與要求的順序相符。

舉例來說,假設您使用 4 次更新來呼叫 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)

更新回覆。此地圖與更新內容進行 1:1 對應,但某些要求的回覆可能是空白的。

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。