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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
欄位
presentationId

string

更新套用的簡報。
replies[]

object (Response)

更新的回覆。這會與更新內容 1:1 對應，但部分要求的相關回覆可能為空白。
writeControl

object (WriteControl)

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

enum (CommentUpdateState)

批次要求中是否套用留言更新。

授權範圍

需要下列其中一種 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。

CommentUpdateState

批次要求中註解更新的狀態。

列舉
COMMENT_UPDATE_STATE_UNSPECIFIED 未指定註解更新狀態。
NO_UPDATES_REQUESTED 批次要求中未要求更新任何留言。
ALL_SAVED 批次要求中已套用所有要求的註解更新。
ALL_FAILED_UNKNOWN_REASON 所有要求的註解更新作業都失敗。