Мастер презентации.
Мастер-файлы содержат все общие элементы страниц и общие свойства набора макетов. Они служат трем целям:
- Фигуры-заполнители на шаблоне содержат стили текста по умолчанию и свойства фигур всех фигур-заполнителей на страницах, использующих этот мастер.
- Свойства главной страницы определяют общие свойства страницы, унаследованные ее макетами.
- Любые другие фигуры на мастер-слайде отображаются на всех слайдах, использующих этот мастер, независимо от их макета.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
get Background() | Page Background | Получает фон страницы. |
get Color Scheme() | Color Scheme | Получает Color Scheme , связанную со страницей. |
get Groups() | Group[] | Возвращает список объектов Group на странице. |
get Images() | Image[] | Возвращает список объектов Image на странице. |
get Layouts() | Layout[] | Получает макеты этого мастера. |
get Lines() | Line[] | Возвращает список объектов Line на странице. |
get Object Id() | String | Получает уникальный идентификатор страницы. |
get Page Element By Id(id) | Page Element | Возвращает Page Element на странице с заданным идентификатором или null , если таковой не существует. |
get Page Elements() | Page Element[] | Возвращает список объектов Page Element отображаемых на странице. |
get Page Type() | Page Type | Получает тип страницы. |
get Placeholder(placeholderType) | Page Element | Возвращает объект Page Element заполнителя для указанного Placeholder Type или null , если соответствующий заполнитель отсутствует. |
get Placeholder(placeholderType, placeholderIndex) | Page Element | Возвращает объект Page Element -заполнителя для указанного Placeholder Type и индекса заполнителя или null , если заполнитель отсутствует. |
get Placeholders() | Page Element[] | Возвращает список объектов-заполнителей Page Element на странице. |
get Shapes() | Shape[] | Возвращает список объектов Shape на странице. |
get Sheets Charts() | Sheets Chart[] | Возвращает список объектов Sheets Chart на странице. |
get Tables() | Table[] | Возвращает список объектов Table на странице. |
get Videos() | Video[] | Возвращает список объектов Video на странице. |
get Word Arts() | Word Art[] | Возвращает список объектов Word Art на странице. |
group(pageElements) | Group | Группирует все указанные элементы страницы. |
insert Group(group) | Group | Вставляет копию предоставленной Group на страницу. |
insert Image(blobSource) | Image | Вставляет изображение в верхний левый угол страницы с размером по умолчанию из указанного BLOB-объекта изображения. |
insert Image(blobSource, left, top, width, height) | Image | Вставляет изображение на страницу с заданным положением и размером из указанного BLOB-объекта изображения. |
insert Image(image) | Image | Вставляет копию предоставленного Image на страницу. |
insert Image(imageUrl) | Image | Вставляет изображение в верхний левый угол страницы с размером по умолчанию из предоставленного URL-адреса. |
insert Image(imageUrl, left, top, width, height) | Image | Вставляет изображение на страницу с указанным положением и размером из предоставленного URL-адреса. |
insert Line(line) | Line | Вставляет копию предоставленной Line на страницу. |
insert Line(lineCategory, startConnectionSite, endConnectionSite) | Line | Вставляет на страницу линию, соединяющую два connection sites . |
insert Line(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Вставляет строку на страницу. |
insert Page Element(pageElement) | Page Element | Вставляет копию предоставленного Page Element на страницу. |
insert Shape(shape) | Shape | Вставляет копию предоставленной Shape на страницу. |
insert Shape(shapeType) | Shape | Вставляет фигуру на страницу. |
insert Shape(shapeType, left, top, width, height) | Shape | Вставляет фигуру на страницу. |
insert Sheets Chart(sourceChart) | Sheets Chart | Вставляет диаграмму Google Sheets на страницу. |
insert Sheets Chart(sourceChart, left, top, width, height) | Sheets Chart | Вставляет диаграмму Google Sheets на страницу с указанным положением и размером. |
insert Sheets Chart(sheetsChart) | Sheets Chart | Вставляет копию предоставленной Sheets Chart на страницу. |
insert Sheets Chart As Image(sourceChart) | Image | Вставляет диаграмму Google Sheets в виде Image на страницу. |
insert Sheets Chart As Image(sourceChart, left, top, width, height) | Image | Вставляет диаграмму Google Sheets в виде Image на страницу с указанным положением и размером. |
insert Table(numRows, numColumns) | Table | Вставляет таблицу на страницу. |
insert Table(numRows, numColumns, left, top, width, height) | Table | Вставляет таблицу на страницу с указанным положением и размером. |
insert Table(table) | Table | Вставляет копию предоставленной Table на страницу. |
insert Text Box(text) | Shape | Вставляет на страницу текстовое поле Shape содержащее предоставленную строку. |
insert Text Box(text, left, top, width, height) | Shape | Вставляет на страницу текстовое поле Shape содержащее предоставленную строку. |
insert Video(videoUrl) | Video | Вставляет видео в верхний левый угол страницы с размером по умолчанию. |
insert Video(videoUrl, left, top, width, height) | Video | Вставляет видео на страницу с заданным положением и размером. |
insert Video(video) | Video | Вставляет копию предоставленного Video на страницу. |
insert Word Art(wordArt) | Word Art | Вставляет копию предоставленного Word Art на страницу. |
remove() | void | Удаляет страницу. |
replace All Text(findText, replaceText) | Integer | Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены. |
replace All Text(findText, replaceText, matchCase) | Integer | Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены. |
select As Current Page() | void | Выбирает Page в активной презентации в качестве current page selection и удаляет любой предыдущий выбор. |
Подробная документация
get Background()
Получает фон страницы.
Возвращаться
Page Background
— фон страницы.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Color Scheme()
Получает Color Scheme
, связанную со страницей.
Возвращаться
Color Scheme
— цветовая схема страницы.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Groups()
Возвращает список объектов Group
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Images()
Возвращает список объектов Image
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Layouts()
Получает макеты этого мастера.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Lines()
Возвращает список объектов Line
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Object Id()
Получает уникальный идентификатор страницы. Идентификаторы объектов, используемые страницами и элементами страниц, используют одно и то же пространство имен.
Возвращаться
String
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element By Id(id)
Возвращает Page Element
на странице с заданным идентификатором или null
, если таковой не существует.
Параметры
Имя | Тип | Описание |
---|---|---|
id | String | Идентификатор извлекаемого элемента страницы. |
Возвращаться
Page Element
— элемент страницы с заданным идентификатором.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Elements()
Возвращает список объектов Page Element
отображаемых на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Type()
Получает тип страницы.
Возвращаться
Page Type
— тип страницы.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType)
Возвращает объект Page Element
заполнителя для указанного Placeholder Type
или null
, если соответствующий заполнитель отсутствует.
Если существует несколько заполнителей одного и того же типа, возвращается тот, у которого минимальный индекс заполнителя. Если существует несколько совпадающих заполнителей с одним и тем же индексом, он возвращает первый заполнитель из коллекции элементов страницы.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Параметры
Имя | Тип | Описание |
---|---|---|
placeholder Type | Placeholder Type |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType, placeholderIndex)
Возвращает объект Page Element
-заполнителя для указанного Placeholder Type
и индекса заполнителя или null
, если заполнитель отсутствует.
Если существует несколько заполнителей с одним и тем же типом и индексом, он возвращает первый заполнитель из коллекции элементов страницы.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Параметры
Имя | Тип | Описание |
---|---|---|
placeholder Type | Placeholder Type | |
placeholder Index | Integer |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholders()
Возвращает список объектов-заполнителей Page Element
на странице.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Shapes()
Возвращает список объектов Shape
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Sheets Charts()
Возвращает список объектов Sheets Chart
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Tables()
Возвращает список объектов Table
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Videos()
Возвращает список объектов Video
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Word Arts()
Возвращает список объектов Word Art
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
group(pageElements)
Группирует все указанные элементы страницы.
На одной странице должно быть как минимум два элемента страницы, которых еще нет в другой группе. Некоторые элементы страницы, такие как Videos
, Tables
и placeholder Shapes
невозможно сгруппировать.
Параметры
Имя | Тип | Описание |
---|---|---|
page Elements | Page Element[] | Элементы, которые нужно сгруппировать. |
Возвращаться
Group
— Новая группа.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Group(group)
Вставляет копию предоставленной Group
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a group between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup( group); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
group | Group | Группа, которую необходимо скопировать и вставить. |
Возвращаться
Group
— вставленная группа.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource)
Вставляет изображение в верхний левый угол страницы с размером по умолчанию из указанного BLOB-объекта изображения.
При вставке изображения оно извлекается из Blob Source
один раз, а копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в формате PNG, JPEG или GIF.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Параметры
Имя | Тип | Описание |
---|---|---|
blob Source | Blob Source | Данные изображения. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource, left, top, width, height)
Вставляет изображение на страницу с заданным положением и размером из указанного BLOB-объекта изображения.
Изображение извлекается из предоставленного Blob Source
один раз во время вставки, а копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в формате PNG, JPEG или GIF.
Чтобы сохранить соотношение сторон изображения, оно масштабируется и центрируется относительно заданного размера.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); const position = { left: 0, top: 0 }; const size = { width: 300, height: 100 }; slide.insertImage(image, position.left, position.top, size.width, size.height);
Параметры
Имя | Тип | Описание |
---|---|---|
blob Source | Blob Source | Данные изображения. |
left | Number | Горизонтальное положение изображения в точках, измеряемое от верхнего левого угла страницы. |
top | Number | Вертикальное положение изображения в точках, измеряемое от верхнего левого угла страницы. |
width | Number | Ширина изображения в пунктах. |
height | Number | Высота изображения в пунктах. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(image)
Вставляет копию предоставленного Image
на страницу.
Положение вставленных изображений на этой странице определяется по положению исходного изображения на соответствующей странице.
Если предоставленное изображение является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главных страниц или страниц макета, также наследуются от вставленного изображения.
Если предоставленное изображение является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в изображение из исходной презентации. Если скопированное изображение-заполнитель пусто, в целевую презентацию ничего не вставляется.
// Copy an image between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Параметры
Имя | Тип | Описание |
---|---|---|
image | Image | Изображение, которое необходимо скопировать и вставить. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl)
Вставляет изображение в верхний левый угол страницы с размером по умолчанию из предоставленного URL-адреса.
При вставке изображения оно извлекается из URL-адреса один раз, а копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в формате PNG, JPEG или GIF.
Предоставленный URL-адрес должен быть общедоступным и иметь размер не более 2 КБ. Сам URL-адрес сохраняется вместе с изображением и предоставляется через Image.getSourceUrl()
.
Параметры
Имя | Тип | Описание |
---|---|---|
image Url | String | URL-адрес изображения. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl, left, top, width, height)
Вставляет изображение на страницу с указанным положением и размером из предоставленного URL-адреса.
При вставке изображения оно извлекается из URL-адреса один раз, а копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в формате PNG, JPEG или GIF.
Предоставленный URL-адрес должен быть общедоступным и иметь размер не более 2 КБ. Сам URL-адрес сохраняется вместе с изображением и предоставляется через Image.getSourceUrl()
.
Чтобы сохранить соотношение сторон изображения, оно масштабируется и центрируется относительно заданного размера.
Параметры
Имя | Тип | Описание |
---|---|---|
image Url | String | URL-адрес изображения. |
left | Number | Горизонтальное положение изображения в точках, измеряемое от верхнего левого угла страницы. |
top | Number | Вертикальное положение изображения в точках, измеряемое от верхнего левого угла страницы. |
width | Number | Ширина изображения в пунктах. |
height | Number | Высота изображения в пунктах. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(line)
Вставляет копию предоставленной Line
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a line between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Параметры
Имя | Тип | Описание |
---|---|---|
line | Line | Строка, которую необходимо скопировать и вставить. |
Возвращаться
Line
— вставленная строка.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Вставляет на страницу линию, соединяющую два connection sites
. На этой странице должны быть два сайта подключения.
// Insert a line in the first slide of the presentation connecting two shapes. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1], );
Параметры
Имя | Тип | Описание |
---|---|---|
line Category | Line Category | Категория вставляемой строки. |
start Connection Site | Connection Site | Место подключения, к которому должно быть подключено начало линии. |
end Connection Site | Connection Site | Место подключения, к которому должен быть подключен конец линии. |
Возвращаться
Line
— вставленная строка.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Вставляет строку на страницу.
// Insert a line in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const startPoint = { left: 10, top: 10 }; const endPoint = { left: 40, top: 40 }; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top, );
Параметры
Имя | Тип | Описание |
---|---|---|
line Category | Line Category | Категория вставляемой строки. |
start Left | Number | Горизонтальное положение начальной точки линии, измеряемое в пунктах от левого верхнего угла страницы. |
start Top | Number | Вертикальное положение начальной точки линии, измеряемое в пунктах от верхнего левого угла страницы. |
end Left | Number | Горизонтальное положение конечной точки линии, измеряемое в пунктах от левого верхнего угла страницы. |
end Top | Number | Вертикальное положение конечной точки линии, измеряемое в пунктах от левого верхнего угла страницы. |
Возвращаться
Line
— вставленная строка.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Page Element(pageElement)
Вставляет копию предоставленного Page Element
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a page element between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Параметры
Имя | Тип | Описание |
---|---|---|
page Element | Page Element | Элемент страницы, который необходимо скопировать и вставить. |
Возвращаться
Page Element
— вставленный элемент страницы.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shape)
Вставляет копию предоставленной Shape
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a shape between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape( shape); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
shape | Shape | Фигура, которую нужно скопировать и вставить. |
Возвращаться
Shape
— вставленная фигура.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType)
Вставляет фигуру на страницу.
Фигура вставляется с размером по умолчанию в верхнем левом углу страницы.
// Insert a shape in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Параметры
Имя | Тип | Описание |
---|---|---|
shape Type | Shape Type | Тип фигуры для вставки. |
Возвращаться
Shape
— вставленная фигура.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType, left, top, width, height)
Вставляет фигуру на страницу.
Параметры
Имя | Тип | Описание |
---|---|---|
shape Type | Shape Type | Тип фигуры для вставки. |
left | Number | Горизонтальное положение фигуры, измеренное от верхнего левого угла страницы. |
top | Number | Вертикальное положение фигуры, измеренное от верхнего левого угла страницы. |
width | Number | Ширина формы. |
height | Number | Высота фигуры. |
Возвращаться
Shape
— вставленная фигура.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart)
Вставляет диаграмму Google Sheets на страницу.
Диаграмма вставляется с размером по умолчанию в верхнем левом углу страницы.
Вставленная диаграмма связана с исходной диаграммой Google Таблиц, что позволяет ее обновлять. Другие соавторы могут видеть ссылку на исходную таблицу.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Параметры
Имя | Тип | Описание |
---|---|---|
source Chart | Embedded Chart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
Возвращаться
Sheets Chart
— вставленная диаграмма на страницу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart, left, top, width, height)
Вставляет диаграмму Google Sheets на страницу с указанным положением и размером.
Чтобы сохранить соотношение сторон диаграммы, она масштабируется и центрируется относительно заданного размера.
Вставленная диаграмма связана с исходной диаграммой Google Sheets, что позволяет ее обновлять. Другие соавторы могут видеть ссылку на исходную таблицу.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height, );
Параметры
Имя | Тип | Описание |
---|---|---|
source Chart | Embedded Chart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
left | Number | Горизонтальное положение графика в пунктах, отсчитываемое от левого верхнего угла страницы. |
top | Number | Вертикальное положение диаграммы в пунктах, измеряемое от левого верхнего угла страницы. |
width | Number | Ширина графика в пунктах. |
height | Number | Высота графика в пунктах. |
Возвращаться
Sheets Chart
— вставленная диаграмма на страницу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sheetsChart)
Вставляет копию предоставленной Sheets Chart
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a sheets chart between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Параметры
Имя | Тип | Описание |
---|---|---|
sheets Chart | Sheets Chart | Диаграмма листов, которую необходимо скопировать и вставить. |
Возвращаться
Sheets Chart
— диаграмма вставленных листов.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(sourceChart)
Вставляет диаграмму Google Sheets в виде Image
на страницу.
Изображение диаграммы вставляется с размером по умолчанию в верхний левый угол страницы.
Вставленное изображение диаграммы не связано с исходной диаграммой Google Таблиц.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage( chart); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
source Chart | Embedded Chart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
Возвращаться
Image
— вставленное изображение диаграммы на странице.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(sourceChart, left, top, width, height)
Вставляет диаграмму Google Sheets в виде Image
на страницу с указанным положением и размером.
Чтобы сохранить соотношение сторон изображения диаграммы, оно масштабируется и центрируется относительно заданного размера.
Вставленное изображение диаграммы не связано с исходной диаграммой Google Таблиц.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height, );
Параметры
Имя | Тип | Описание |
---|---|---|
source Chart | Embedded Chart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
left | Number | Горизонтальное положение графика в пунктах, отсчитываемое от левого верхнего угла страницы. |
top | Number | Вертикальное положение диаграммы в пунктах, измеряемое от левого верхнего угла страницы. |
width | Number | Ширина графика в пунктах. |
height | Number | Высота графика в пунктах. |
Возвращаться
Image
— вставленное изображение диаграммы на странице.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns)
Вставляет таблицу на страницу.
Таблица центрируется на странице с размером по умолчанию и равномерно распределенными строками и столбцами.
Параметры
Имя | Тип | Описание |
---|---|---|
num Rows | Integer | Количество строк в таблице. |
num Columns | Integer | Количество столбцов в таблице. |
Возвращаться
Table
— вставленная таблица.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns, left, top, width, height)
Вставляет таблицу на страницу с указанным положением и размером.
В созданной таблице строки и столбцы распределены равномерно.
Параметры
Имя | Тип | Описание |
---|---|---|
num Rows | Integer | Количество строк в таблице. |
num Columns | Integer | Количество столбцов в таблице. |
left | Number | Горизонтальное положение таблицы, измеряемое от верхнего левого угла страницы. |
top | Number | Вертикальное положение таблицы, измеренное от верхнего левого угла страницы. |
width | Number | Ширина стола. |
height | Number | Минимальная высота стола. Фактическая высота отображаемой таблицы зависит от таких факторов, как размер шрифта текста. |
Возвращаться
Table
— вставленная таблица.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(table)
Вставляет копию предоставленной Table
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a table between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable( table); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
table | Table | Таблица, которую необходимо скопировать и вставить. |
Возвращаться
Table
— вставленная таблица.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text)
Вставляет на страницу текстовое поле Shape
содержащее предоставленную строку.
Форма текстового поля вставляется с размером по умолчанию в верхнем левом углу страницы.
// Insert text box with "Hello" on the first slide of presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | Строка, которую должна содержать форма текстового поля. |
Возвращаться
Shape
— форма вставленного текстового поля.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text, left, top, width, height)
Вставляет на страницу текстовое поле Shape
содержащее предоставленную строку.
// Insert text box with "Hello" on the first slide of presentation. This text // box is a square with a length of 10 points on each side. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox( 'Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | Строка, которую должна содержать форма текстового поля. |
left | Number | Горизонтальное положение формы текстового поля, измеренное от верхнего левого угла страницы. |
top | Number | Вертикальное положение формы текстового поля, измеренное от верхнего левого угла страницы. |
width | Number | Ширина формы текстового поля. |
height | Number | Высота формы текстового поля. |
Возвращаться
Shape
— форма вставленного текстового поля.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(videoUrl)
Вставляет видео в верхний левый угол страницы с размером по умолчанию.
В настоящее время поддерживаются только видео YouTube.
Параметры
Имя | Тип | Описание |
---|---|---|
video Url | String | URL-адрес видео для вставки. |
Возвращаться
Video
— вставленное видео.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(videoUrl, left, top, width, height)
Вставляет видео на страницу с заданным положением и размером.
В настоящее время поддерживаются только видео YouTube.
Параметры
Имя | Тип | Описание |
---|---|---|
video Url | String | URL-адрес видео для вставки. |
left | Number | Горизонтальное положение видео в пунктах, измеряемое от левого верхнего угла страницы. |
top | Number | Вертикальное положение видео в пунктах, измеряемое от верхнего левого угла страницы. |
width | Number | Ширина видео в пунктах. |
height | Number | Высота видео в пунктах. |
Возвращаться
Video
— вставленное видео.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(video)
Вставляет копию предоставленного Video
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, наследуемые от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a video between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo( video); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
video | Video | Видео, которое нужно скопировать и вставить. |
Возвращаться
Video
— вставленное видео.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Word Art(wordArt)
Вставляет копию предоставленного Word Art
на страницу.
Положение вставленного элемента на этой странице определяется позицией исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от главной страницы или страницы макета, также наследуются от вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от главной страницы или страницы макета, копируются в элемент из исходной презентации.
// Copy a word art between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Параметры
Имя | Тип | Описание |
---|---|---|
word Art | Word Art | Группа, которую необходимо скопировать и вставить. |
Возвращаться
Word Art
— вставленное художественное слово.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Удаляет страницу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены. Поиск нечувствителен к регистру.
Параметры
Имя | Тип | Описание |
---|---|---|
find Text | String | Текст, который нужно найти. |
replace Text | String | Текст для замены совпавшего текста. |
Возвращаться
Integer
— количество измененных вхождений
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
Заменяет все экземпляры текста, совпадающего с текстом поиска, на текст замены.
Параметры
Имя | Тип | Описание |
---|---|---|
find Text | String | Текст, который нужно найти. |
replace Text | String | Текст для замены совпавшего текста. |
match Case | Boolean | Если true , поиск чувствителен к регистру; если false , поиск нечувствителен к регистру. |
Возвращаться
Integer
— количество измененных вхождений
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select As Current Page()
Выбирает Page
в активной презентации в качестве current page selection
и удаляет любой предыдущий выбор.
Сценарий может получить доступ только к выбору пользователя, запускающего сценарий, и только в том случае, если сценарий привязан к презентации.
// Select the first slide as the current page selection and replace any previous // selection. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations