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

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