Method: presentations.batchUpdate

Применяет одно или несколько обновлений к презентации.

Каждый request проверяется перед применением. Если какой-либо запрос недействителен, то весь запрос завершится неудачно, и ничего не будет применено.

На некоторые запросы есть replies , в которых содержится информация о том, как они применяются. Другие запросы не должны возвращать информацию; каждый из них возвращает пустой ответ. Порядок ответов соответствует порядку запросов.

Например, предположим, что вы вызываете пакетное обновление с четырьмя обновлениями, и только третье возвращает информацию. В ответе будет два пустых ответа: ответ на третий запрос и еще один пустой ответ в таком порядке.

Поскольку другие пользователи могут редактировать презентацию, презентация может не совсем отражать ваши изменения: ваши изменения могут быть изменены по отношению к изменениям соавторов. Если соавторов нет, презентация должна отражать ваши изменения. В любом случае обновления в вашем запросе гарантированно будут применяться атомарно.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования 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 презентации, необходимый для запроса на запись. Если указано и требуемый идентификатор версии не соответствует текущему идентификатору версии презентации, запрос не обрабатывается и возвращает ошибку 400 неверный запрос.

Когда в ответе возвращается требуемый идентификатор редакции, он указывает идентификатор редакции документа после применения запроса.