Method: presentations.create

Создает пустую презентацию, используя заголовок, указанный в запросе. Если указан идентификатор presentationId , он используется в качестве идентификатора новой презентации. В противном случае генерируется новый идентификатор. Другие поля запроса, включая любое предоставленное содержимое, игнорируются. Возвращает созданную презентацию.

HTTP-запрос

POST https://slides.googleapis.com/v1/presentations

В URL-адресе используется синтаксис транскодирования gRPC .

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
Поля
presentationId

string

Идентификатор презентации.

pageSize

object ( Size )

Размер страниц в презентации.

slides[]

object ( Page )

Слайды в презентации. Слайд наследует свойства от макета слайда.

title

string

Название презентации.

masters[]

object ( Page )

Шаблоны слайдов в презентации. Шаблон слайда содержит все стандартные элементы страницы и общие свойства для набора макетов. Они выполняют три функции:

  • На шаблоне страницы содержатся фигуры-заполнители, отображающие стили текста и свойства по умолчанию, аналогичные тем, что используются на страницах, использующих этот шаблон.
  • Свойства главной страницы определяют общие свойства страницы, наследуемые ее макетами.
  • Все остальные фигуры на мастер-слайде отображаются на всех слайдах, использующих этот мастер-слайд, независимо от их расположения.
layouts[]

object ( Page )

Макеты в презентации. Макет — это шаблон, определяющий, как контент располагается и оформляется на слайдах, которые наследуют этот макет.

locale

string

Местоположение презентации, указанное в виде языкового тега IETF BCP 47.

revisionId

string

Только для вывода. Идентификатор ревизии презентации. Может использоваться в запросах на обновление для подтверждения того, что ревизия презентации не изменилась с момента последней операции чтения. Заполняется только в том случае, если у пользователя есть доступ к редактированию презентации.

Идентификатор ревизии — это не порядковый номер, а неопределенная строка. Формат идентификатора ревизии может меняться со временем, поэтому к нему следует относиться непрозрачно. Гарантируется, что возвращенный идентификатор ревизии будет действителен только в течение 24 часов после его возврата и не может быть передан другим пользователям. Если идентификатор ревизии не изменился между вызовами, значит, презентация не изменилась. И наоборот, изменение идентификатора (для той же презентации и того же пользователя) обычно означает, что презентация была обновлена. Однако изменение идентификатора может быть также вызвано внутренними факторами, такими как изменение формата идентификатора.

notesMaster

object ( Page )

Заметки в презентации служат трем целям:

  • На шаблоне заметок фигуры-заполнители содержат стили текста и свойства фигуры по умолчанию, характерные для всех фигур-заполнителей на notes pages . В частности, фигура-заполнитель SLIDE_IMAGE содержит эскиз слайда, а фигура-заполнитель BODY — заметки докладчика.
  • Свойства главной страницы заметок определяют общие свойства страницы, наследуемые всеми notes pages .
  • Все остальные фигуры на шаблоне заметок отображаются на всех notes pages .

Основной файл заметок доступен только для чтения.

comments[]

object ( CommentThread )

Только вывод. Комментарии к презентации.

commentsViewMode

enum ( CommentsViewMode )

Только вывод. К презентации применен режим просмотра комментариев.

Ответный текст

В случае успеха тело ответа будет содержать вновь созданный экземпляр объекта Presentation .

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

Для получения более подробной информации см. руководство по авторизации .