Method: presentations.batchUpdate

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

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

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

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

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

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

Дополнительные сведения см. в руководстве по авторизации .

Управление записью

Обеспечивает контроль над выполнением запросов на запись.

Представление JSON
{
  "requiredRevisionId": string
}
Поля
requiredRevisionId

string

revision ID презентации, необходимой для запроса на запись. Если указан и требуемый идентификатор версии не соответствует текущему идентификатору версии презентации, запрос не обрабатывается и возвращает ошибку неверного запроса 400.

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