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

Если в ответе возвращается необходимый идентификатор ревизии, это означает, что идентификатор ревизии документа был изменен после выполнения запроса.

CommentUpdateState

Статус обновления комментариев в пакетном запросе.

Перечисления
COMMENT_UPDATE_STATE_UNSPECIFIED Статус обновлений комментариев не указан.
NO_UPDATES_REQUESTED В пакетном запросе не запрашивалось никаких обновлений комментариев.
ALL_SAVED Все запрошенные обновления комментариев были внесены в рамках пакетного запроса.
ALL_FAILED_UNKNOWN_REASON Все запрошенные обновления комментариев не удалось.