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。