REST Resource: presentations.pages

Ресурс: Страница

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

JSON-представление
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Поля
objectId

string

Идентификатор объекта для этой страницы. Идентификаторы объектов, используемые Page и PageElement используют одно и то же пространство имен.

pageType

enum ( PageType )

Тип страницы.

pageElements[]

object ( PageElement )

Элементы страницы, отображаемые на странице.

revisionId

string

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

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

pageProperties

object ( PageProperties )

Свойства страницы.

properties поля объединения. Свойства, специфичные для каждого типа страницы. Мастера не требуют каких-либо дополнительных свойств. properties могут быть только одним из следующих:
slideProperties

object ( SlideProperties )

Слайд конкретных свойств. Устанавливается только в том случае, если pageType = SLIDE.

layoutProperties

object ( LayoutProperties )

Конкретные свойства макета. Устанавливается только в том случае, если pageType = LAYOUT.

notesProperties

object ( NotesProperties )

Отмечает конкретные свойства. Устанавливается только в том случае, если pageType = ПРИМЕЧАНИЕ.

masterProperties

object ( MasterProperties )

Освойте определенные свойства. Устанавливается только в том случае, если pageType = MASTER.

Тип страницы

Тип страницы.

Перечисления
SLIDE Страница слайда.
MASTER Страница мастер-слайда.
LAYOUT Страница макета.
NOTES Страница заметок.
NOTES_MASTER Главная страница заметок.

СтраницаЭлемент

Визуальный элемент, отображаемый на странице.

JSON-представление
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
Поля
objectId

string

Идентификатор объекта для этого элемента страницы. Идентификаторы объектов, используемые google.apps.slides.v1.Page и google.apps.slides.v1.PageElement используют одно и то же пространство имен.

size

object ( Size )

Размер элемента страницы.

transform

object ( AffineTransform )

Преобразование элемента страницы.

Внешний вид элемента страницы определяется его абсолютным преобразованием. Чтобы вычислить абсолютное преобразование, предварительно объедините преобразование элемента страницы с преобразованиями всех его родительских групп. Если элемент страницы не входит в группу, его абсолютное преобразование совпадает со значением в этом поле.

Начальное преобразование для вновь созданной Group всегда является преобразованием идентификатора.

title

string

Заголовок элемента страницы. В сочетании с описанием для отображения замещающего текста.

Поле не поддерживается для элементов Group .

description

string

Описание элемента страницы. В сочетании с заголовком для отображения замещающего текста.

Поле не поддерживается для элементов Group .

Поле объединения element_kind . Тип элемента, который представляет этот PageElement. Каждое сообщение содержит любые свойства, специфичные для этого типа элемента страницы. element_kind может быть только одним из следующих:
elementGroup

object ( Group )

Коллекция элементов страницы, объединенных в единое целое.

shape

object ( Shape )

Общая форма.

image

object ( Image )

Элемент страницы изображения.

video

object ( Video )

Элемент видеостраницы.

line

object ( Line )

Строковый элемент страницы.

table

object ( Table )

Элемент страницы таблицы.

wordArt

object ( WordArt )

Элемент страницы Word Art.

sheetsChart

object ( SheetsChart )

Связанная диаграмма, встроенная из Google Таблиц. Несвязанные диаграммы представлены в виде изображений.

speakerSpotlight

object ( SpeakerSpotlight )

Прожектор спикера.

Группа

Вид PageElement , представляющий объединенную коллекцию PageElements.

JSON-представление
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Поля
children[]

object ( PageElement )

Сбор элементов в группе. Минимальный размер группы — 2 человека.

WordArt

Вид PageElement представляющий текстовое искусство.

JSON-представление
{
  "renderedText": string
}
Поля
renderedText

string

Текст отображается в виде художественного слова.

СпикерПрожектор

Вид PageElement , представляющий Spotlight докладчика.

JSON-представление
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Поля
speakerSpotlightProperties

object ( SpeakerSpotlightProperties )

Свойства Прожектора динамика.

ДинамикПрожекторСвойства

Свойства SpeakerSpotlight .

JSON-представление
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Поля
outline

object ( Outline )

Схема прожектора динамика. Если не установлено, оно не имеет контура.

shadow

object ( Shadow )

Тень прожектора динамика. Если не установлено, тени не будет.

Свойства слайда

Свойства Page , которые актуальны только для страниц с типом страницы SLIDE.

JSON-представление
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Поля
layoutObjectId

string

Идентификатор объекта макета, на котором основан этот слайд. Это свойство доступно только для чтения.

masterObjectId

string

Идентификатор объекта мастера, на котором основан этот слайд. Это свойство доступно только для чтения.

notesPage

object ( Page )

Страница заметок, с которой связан этот слайд. Он определяет внешний вид страницы заметок при печати или экспорте слайдов с заметками докладчика. Страница заметок наследует свойства от notes master . Фигура-заполнитель с типом BODY на странице заметок содержит заметки докладчика для этого слайда. Идентификатор этой фигуры определяется speakerNotesObjectId . Страница заметок доступна только для чтения, за исключением текстового содержимого и стилей формы заметок докладчика. Это свойство доступно только для чтения.

isSkipped

boolean

Пропускается ли слайд в режиме презентации. По умолчанию ложь.

Свойства макета

Свойства Page актуальны только для страниц с типом страницы LAYOUT.

JSON-представление
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Поля
masterObjectId

string

Идентификатор объекта мастера, на котором основан этот макет.

name

string

Название макета.

displayName

string

Читабельное имя макета.

ЗаметкиСвойства

Свойства Page , которые актуальны только для страниц с типом страницы. ПРИМЕЧАНИЯ.

JSON-представление
{
  "speakerNotesObjectId": string
}
Поля
speakerNotesObjectId

string

Идентификатор объекта фигуры на этой странице заметок, которая содержит заметки докладчика для соответствующего слайда. Фактическая форма не всегда может существовать на странице заметок. Вставка текста с использованием этого идентификатора объекта автоматически создаст фигуру. В этом случае фактическая фигура может иметь другой идентификатор объекта. Действие presentations.get или pages.get всегда будет возвращать последний идентификатор объекта.

МастерСвойства

Свойства Page , которые актуальны только для страниц с типом страницы MASTER.

JSON-представление
{
  "displayName": string
}
Поля
displayName

string

Читабельное имя мастера.

Свойства страницы

Свойства Page .

Страница унаследует свойства родительской страницы. В зависимости от типа страницы иерархия определяется либо в SlideProperties , либо LayoutProperties .

JSON-представление
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Поля
pageBackgroundFill

object ( PageBackgroundFill )

Фоновая заливка страницы. Если этот параметр не установлен, фоновая заливка наследуется от родительской страницы, если она существует. Если у страницы нет родительского элемента, то фоновая заливка по умолчанию соответствует соответствующей заливке в редакторе слайдов.

colorScheme

object ( ColorScheme )

Цветовая гамма страницы. Если не установлено, цветовая схема наследуется от родительской страницы. Если у страницы нет родительского элемента, цветовая схема использует цветовую схему слайдов по умолчанию, соответствующую настройкам по умолчанию в редакторе слайдов.

Редактировать можно только конкретные цвета первых 12 ThemeColorType . Кроме того, можно обновить только цветовую схему на Master страницах. Чтобы обновить поле, необходимо предоставить цветовую схему, содержащую сопоставления всех первых 12 типов ThemeColorTypes с их конкретными цветами. Цвета остальных типов ThemeColorTypes будут игнорироваться.

СтраницаФонЗаполнить

Заливка фона страницы.

JSON-представление
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Поля
propertyState

enum ( PropertyState )

Состояние свойства фоновой заливки.

Обновление заливки на странице неявно обновит это поле до RENDERED , если в том же запросе не указано другое значение. Чтобы на странице не было заливки, установите для этого поля значение NOT_RENDERED . В этом случае любые другие поля заполнения, заданные в том же запросе, будут игнорироваться.

kind поля Союза. Вид заливки фона. kind может быть только одним из следующих:
solidFill

object ( SolidFill )

Сплошная цветная заливка.

stretchedPictureFill

object ( StretchedPictureFill )

Растянутая заливка изображения.

РастянутаяКартинкаЗаполнить

Растянутая заливка изображения. Страница или элемент страницы полностью заполняется указанной картинкой. Изображение растягивается по размеру своего контейнера.

JSON-представление
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Поля
contentUrl

string

Чтение contentUrl:

URL-адрес изображения со временем жизни по умолчанию 30 минут. Этот URL-адрес помечен учетной записью запрашивающего. Любой, у кого есть URL-адрес, фактически получает доступ к изображению как первоначальный запрашивающий. Доступ к изображению может быть утерян, если изменяются настройки общего доступа к презентации.

Написание contentUrl:

Изображение извлекается один раз во время вставки, а его копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в формате PNG, JPEG или GIF.

Длина предоставленного URL-адреса не может превышать 2 КБ.

size

object ( Size )

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

Цветовая схема

Палитра предопределенных цветов для страницы.

JSON-представление
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Поля
colors[]

object ( ThemeColorPair )

ThemeColorType и соответствующие конкретные пары цветов.

ТемаЦветПара

Пара, сопоставляющая цветовой тип темы с конкретным цветом, который он представляет.

JSON-представление
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Поля
type

enum ( ThemeColorType )

Тип цвета темы.

color

object ( RgbColor )

Конкретный цвет, соответствующий цветовому типу темы, указанному выше.

Методы

get

 Получает последнюю версию указанной страницы в презентации.

getThumbnail

 Создает миниатюру последней версии указанной страницы в презентации и возвращает URL-адрес миниатюры изображения.