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)
  }
}
Поля
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 .

Мастер заметок доступен только для чтения.

Тело ответа

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

Области авторизации

Требуется одна из следующих областей OAuth:

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

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