Создает пустую презентацию, используя заголовок, указанный в запросе. Если предоставляется presentationId
, он используется в качестве идентификатора новой презентации. В противном случае создается новый идентификатор. Другие поля в запросе, включая любой предоставленный контент, игнорируются. Возвращает созданную презентацию.
HTTP-запрос
POST https://slides.googleapis.com/v1/presentations
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные со следующей структурой:
Представление JSON |
---|
{ "presentationId": string, "pageSize": { object ( |
Поля | |
---|---|
presentationId | Идентификатор презентации. |
pageSize | Размер страниц в презентации. |
slides[] | Слайды в презентации. Слайд наследует свойства макета слайда. |
title | Название презентации. |
masters[] | Образцы слайдов в презентации. Образец слайдов содержит все общие элементы страницы и общие свойства для набора макетов. Они служат трем целям:
|
layouts[] | Макеты в презентации. Макет — это шаблон, который определяет, как содержимое упорядочивается и оформляется на слайдах, наследуемых от этого макета. |
locale | Локаль презентации в виде языкового тега IETF BCP 47. |
revisionId | Только вывод. Идентификатор версии презентации. Может использоваться в запросах на обновление, чтобы подтвердить, что версия представления не изменилась с момента последней операции чтения. Заполняется только в том случае, если у пользователя есть доступ к редактированию презентации. Идентификатор версии — это не порядковый номер, а туманная строка. Формат идентификатора версии может меняться со временем, поэтому с ним следует обращаться непрозрачно. Возвращенный идентификатор версии гарантированно действителен только в течение 24 часов после его возврата и не может быть передан другим пользователям. Если идентификатор редакции не меняется между вызовами, то представление не изменилось. И наоборот, измененный идентификатор (для той же презентации и пользователя) обычно означает, что презентация была обновлена. Однако изменение идентификатора также может быть вызвано внутренними факторами, такими как изменение формата идентификатора. |
notesMaster | Мастер отмечает в презентации. Он служит трем целям:
Мастер заметок доступен только для чтения. |
Тело ответа
В случае успеха тело ответа содержит только что созданный экземпляр Presentation
.
Области авторизации
Требуется одна из следующих областей действия OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/presentations
Дополнительные сведения см. в руководстве по авторизации .