- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Запрос
- CreateSlideRequest
- Справочник по макету
- Предопределенный макет
- LayoutPlaceholderIdMapping
- CreateShapeRequest
- СтраницаЭлементСвойства
- CreateTableRequest
- Вставитьтекстрекуест
- Инсертетаблеровсрекуест
- Инсертетаблеколумнсрекуест
- УдалитьТаблеРоврекуест
- Удалитьтаблеколумнрекуест
- Заменить все текстовые запросы
- SubstringMatchCriteria
- УдалитьОбъектЗапрос
- Упдейпажеэлементтрансформрекуест
- ПрименитьМоде
- Упдейтслидеспозитионрекуест
- Удалитьтекстрекуест
- Диапазон
- Тип
- CreateImageRequest
- СоздатьВидеоЗапрос
- CreateSheetsChartRequest
- LinkingMode
- CreateLineRequest
- Категория
- RefreshSheetsChartRequest
- Обновитьшейпепропертиесрекуест
- Упдеймажепропертиесрекуест
- Обновитьвидеопропертиесрекуест
- Упдейпажепропертиесрекуест
- Упдаттаблеллеллпропертиесрекуест
- Таблица Диапазон
- Упдейлайнепропертиесрекуест
- CreateParagraphBulletsRequest
- BulletGlyphPreset
- Заменить все фигуры с имажерекуест
- Заменить метод
- ImageReplaceMethod
- Дубликатобжектрекуест
- Обновлениетекстстилерекуест
- ReplaceAllShapesWithSheetsChartRequest
- LinkingMode
- DeleteParagraphBulletsRequest
- Обновление ПараграфСтилерекуест
- Упдатаблебордерпропертиесрекуест
- ГраницаПозиция
- Упдатаблеколумнпропертиесрекуест
- Упдаттаблеровпропертиесрекуест
- слияниетаблецеллсрекуест
- UnmergeTableCellsRequest
- ГруппОбъектсЗапрос
- РазгруппироватьОбъектыЗапрос
- Упдейпажелементалттекстрекуест
- Запрос на замену изображения
- Обновитьслайдпропертиесрекуест
- ОбновлениеPageElementsZOrderRequest
- ZЗаказОперация
- UpdateLineCategoryRequest
- RerouteLineRequest
- Управление записью
- Ответ
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- Заменить все текстовые ответы
- CreateImageResponse
- СоздатьВидеоответ
- CreateSheetsChartResponse
- CreateLineResponse
- Заменить все фигуры с изображением ответа
- ДубликатОбжектОтвет
- ReplaceAllShapesWithSheetsChartResponse
- ГруппОбъектсОтвет
- Попробуй это!
Применяет одно или несколько обновлений к презентации.
Каждый request
проверяется перед применением. Если какой-либо запрос недействителен, весь запрос завершится ошибкой, и ничего не будет применено.
На некоторые запросы есть replies
, чтобы предоставить вам некоторую информацию о том, как они применяются. Другие запросы не должны возвращать информацию; каждый из них возвращает пустой ответ. Порядок ответов соответствует порядку запросов.
Например, предположим, что вы вызываете команду batchUpdate с четырьмя обновлениями, и только третье из них возвращает информацию. В ответе будет два пустых ответа: ответ на третий запрос и еще один пустой ответ в указанном порядке.
Поскольку другие пользователи могут редактировать презентацию, презентация может не совсем точно отражать ваши изменения: ваши изменения могут быть изменены по отношению к изменениям соавтора. Если соавторов нет, презентация должна отражать ваши изменения. В любом случае обновления в вашем запросе гарантированно будут применяться вместе атомарно.
HTTP-запрос
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
presentationId | Презентация, к которой применяются обновления. |
Тело запроса
Тело запроса содержит данные со следующей структурой:
Представление JSON |
---|
{ "requests": [ { object ( |
Поля | |
---|---|
requests[] | Список обновлений, которые нужно применить к презентации. |
writeControl | Обеспечивает контроль над выполнением запросов на запись. |
Тело ответа
Ответное сообщение от пакетного обновления.
В случае успеха тело ответа содержит данные со следующей структурой:
Представление JSON |
---|
{ "presentationId": string, "replies": [ { object ( |
Поля | |
---|---|
presentationId | Презентация, к которой были применены обновления. |
replies[] | Ответ обновлений. Это соответствует обновлениям 1:1, хотя ответы на некоторые запросы могут быть пустыми. |
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 | Когда требуемый идентификатор редакции возвращается в ответе, он указывает идентификатор редакции документа после применения запроса. |