Method: presentations.batchUpdate

对演示文稿应用一项或多项更新。

系统会在应用前验证每个 request。如果任何请求无效,则整个请求将会失败,并且不会应用任何内容。

有些请求会提供 replies,以便为您提供一些有关它们如何应用的信息。其他请求不需要返回信息;每个请求都会返回一个空回复。回复的顺序与请求的顺序一致。

例如,假设您调用批处理更新涉及四个更新,并且只有第三个更新返回信息。回复会有两个空白回复:依次回复第三个请求和另一个空白回复。

由于其他用户可能正在编辑演示文稿,因此该演示文稿可能无法准确反映您的更改:您的更改可能会因协作者所做的更改而发生变化。如果没有协作者,则该演示文稿应反映您的更改。在任何情况下,都可确保请求中的更新以原子方式同时应用。

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

如需了解详情,请参阅授权指南

写入控件

控制写入请求的执行方式。

JSON 表示法
{
  "requiredRevisionId": string
}
字段
requiredRevisionId

string

写入请求的演示文稿的 revision ID。如果指定,但所需的修订版本 ID 与演示文稿的当前修订版本 ID 不匹配,则系统不会处理请求并返回 400 错误请求错误。

当响应中返回所需的修订版本 ID 时,它会指明应用请求后的文档的修订版本 ID。