Мастер в презентации.
Мастера содержат все общие элементы страницы и общие свойства для набора макетов. Они служат трем целям:
- Фигуры-заполнители на образце содержат стили текста по умолчанию и свойства фигур всех фигур-заполнителей на страницах, использующих этот образец.
- Свойства эталонной страницы определяют общие свойства страницы, наследуемые ее макетами.
- Любые другие фигуры на мастер-слайде отображаются на всех слайдах, использующих этот мастер-слайд, независимо от их макета.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
getBackground() | PageBackground | Получает фон страницы. |
getColorScheme() | ColorScheme | Получает ColorScheme , связанную со страницей. |
getGroups() | Group[] | Возвращает список объектов Group на странице. |
getImages() | Image[] | Возвращает список объектов Image на странице. |
getLayouts() | Layout[] | Получает макеты этого мастера. |
getLines() | Line[] | Возвращает список объектов Line на странице. |
getObjectId() | String | Получает уникальный идентификатор страницы. |
getPageElementById(id) | PageElement | Возвращает PageElement на странице с заданным идентификатором или null , если таковой не существует. |
getPageElements() | PageElement[] | Возвращает список объектов PageElement , отображаемых на странице. |
getPageType() | PageType | Получает тип страницы. |
getPlaceholder(placeholderType) | PageElement | Возвращает объект-заполнитель PageElement для указанного PlaceholderType или null , если соответствующий заполнитель отсутствует. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Возвращает объект PageElement заполнителя для указанного PlaceholderType и индекса заполнителя или null , если заполнитель отсутствует. |
getPlaceholders() | PageElement[] | Возвращает список объектов-заполнителей PageElement на странице. |
getShapes() | Shape[] | Возвращает список объектов Shape на странице. |
getSheetsCharts() | SheetsChart[] | Возвращает список объектов SheetsChart на странице. |
getTables() | Table[] | Возвращает список объектов Table на странице. |
getVideos() | Video[] | Возвращает список объектов Video на странице. |
getWordArts() | WordArt[] | Возвращает список объектов WordArt на странице. |
group(pageElements) | Group | Группирует все указанные элементы страницы. |
insertGroup(group) | Group | Вставляет копию предоставленной Group на страницу. |
insertImage(blobSource) | Image | Вставляет изображение в верхнем левом углу страницы с размером по умолчанию из указанного большого двоичного объекта изображения. |
insertImage(blobSource, left, top, width, height) | Image | Вставляет изображение на страницу с указанным положением и размером из указанного большого двоичного объекта изображения. |
insertImage(image) | Image | Вставляет копию предоставленного Image на страницу. |
insertImage(imageUrl) | Image | Вставляет изображение в верхний левый угол страницы с размером по умолчанию из указанного URL-адреса. |
insertImage(imageUrl, left, top, width, height) | Image | Вставляет изображение на страницу с указанным положением и размером из предоставленного URL-адреса. |
insertLine(line) | Line | Вставляет копию предоставленной Line на страницу. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Вставляет на страницу линию, соединяющую два connection sites . |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Вставляет строку на страницу. |
insertPageElement(pageElement) | PageElement | Вставляет копию предоставленного PageElement на страницу. |
insertShape(shape) | Shape | Вставляет копию предоставленной Shape на страницу. |
insertShape(shapeType) | Shape | Вставляет фигуру на страницу. |
insertShape(shapeType, left, top, width, height) | Shape | Вставляет фигуру на страницу. |
insertSheetsChart(sourceChart) | SheetsChart | Вставляет диаграмму Google Sheets на страницу. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Вставляет диаграмму Google Sheets на страницу с указанным положением и размером. |
insertSheetsChart(sheetsChart) | SheetsChart | Вставляет копию предоставленного SheetsChart на страницу. |
insertSheetsChartAsImage(sourceChart) | Image | Вставляет диаграмму Google Sheets в виде Image на страницу. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Вставляет диаграмму Google Sheets в виде Image на страницу с указанным положением и размером. |
insertTable(numRows, numColumns) | Table | Вставляет таблицу на страницу. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Вставляет таблицу на страницу с указанным положением и размером. |
insertTable(table) | Table | Вставляет копию предоставленной Table на страницу. |
insertTextBox(text) | Shape | Вставляет Shape текстового поля, содержащую предоставленную строку, на страницу. |
insertTextBox(text, left, top, width, height) | Shape | Вставляет Shape текстового поля, содержащую предоставленную строку, на страницу. |
insertVideo(videoUrl) | Video | Вставляет видео в верхний левый угол страницы с размером по умолчанию. |
insertVideo(videoUrl, left, top, width, height) | Video | Вставляет видео на страницу с указанным положением и размером. |
insertVideo(video) | Video | Вставляет копию предоставленного Video на страницу. |
insertWordArt(wordArt) | WordArt | Вставляет копию предоставленного объекта WordArt на страницу. |
remove() | void | Удаляет страницу. |
replaceAllText(findText, replaceText) | Integer | Заменяет все вхождения текста, совпадающего с поисковым текстом, на замещающий текст. |
replaceAllText(findText, replaceText, matchCase) | Integer | Заменяет все вхождения текста, совпадающего с поисковым текстом, на замещающий текст. |
selectAsCurrentPage() | void | Выбирает Page в активной презентации в качестве current page selection и удаляет любой предыдущий выбор. |
Подробная документация
getBackground()
Получает фон страницы.
Возвращаться
PageBackground
— Фон страницы.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getColorScheme()
Получает ColorScheme
, связанную со страницей.
Возвращаться
ColorScheme
— цветовая схема страницы.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
getImages()
getLayouts()
getLines()
getObjectId()
Получает уникальный идентификатор страницы. Идентификаторы объектов, используемые страницами и элементами страницы, имеют одно и то же пространство имен.
Возвращаться
String
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Возвращает PageElement
на странице с заданным идентификатором или null
, если таковой не существует.
Параметры
Имя | Тип | Описание |
---|---|---|
id | String | Идентификатор элемента страницы, который извлекается. |
Возвращаться
PageElement
— элемент страницы с заданным идентификатором.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
Возвращает список объектов PageElement
, отображаемых на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
Возвращает объект-заполнитель PageElement
для указанного PlaceholderType
или null
, если соответствующий заполнитель отсутствует.
Если имеется несколько заполнителей одного типа, возвращается тот, у которого минимальный индекс заполнителя. Если имеется несколько совпадающих заполнителей с одним и тем же индексом, возвращается первый заполнитель из коллекции элементов страницы.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Параметры
Имя | Тип | Описание |
---|---|---|
placeholderType | PlaceholderType |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Возвращает объект PageElement
заполнителя для указанного PlaceholderType
и индекса заполнителя или null
, если заполнитель отсутствует.
Если имеется несколько заполнителей с одинаковым типом и индексом, возвращается первый заполнитель из коллекции элементов страницы.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Параметры
Имя | Тип | Описание |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholders()
Возвращает список объектов-заполнителей PageElement
на странице.
var 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
getShapes()
getSheetsCharts()
Возвращает список объектов SheetsChart
на странице.
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
Группирует все указанные элементы страницы.
На одной странице должно быть как минимум два элемента страницы, которые еще не находятся в другой группе. Некоторые элементы страницы, такие как Videos
, Tables
и placeholder Shapes
нельзя сгруппировать.
Параметры
Имя | Тип | Описание |
---|---|---|
pageElements | PageElement[] | Элементы для группировки. |
Возвращаться
Group
— Новая группа.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
Вставляет копию предоставленной Group
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a group between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var 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
insertImage(blobSource)
Вставляет изображение в верхнем левом углу страницы с размером по умолчанию из указанного большого двоичного объекта изображения.
При вставке изображение извлекается из BlobSource
один раз, а копия сохраняется для отображения в презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Параметры
Имя | Тип | Описание |
---|---|---|
blobSource | BlobSource | Данные изображения. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
Вставляет изображение на страницу с указанным положением и размером из указанного большого двоичного объекта изображения.
Изображение извлекается из предоставленного BlobSource
один раз во время вставки, а копия сохраняется для отображения в презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.
Чтобы сохранить пропорции изображения, изображение масштабируется и центрируется относительно предоставленного размера.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); var position = {left: 0, top: 0}; var size = {width: 300, height: 100}; slide.insertImage(image, position.left, position.top, size.width, size.height);
Параметры
Имя | Тип | Описание |
---|---|---|
blobSource | BlobSource | Данные изображения. |
left | Number | Горизонтальное положение изображения в пунктах, измеренное от левого верхнего угла страницы. |
top | Number | Вертикальное положение изображения в пунктах, измеренное от левого верхнего угла страницы. |
width | Number | Ширина изображения в точках. |
height | Number | Высота изображения в пунктах. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
Вставляет копию предоставленного Image
на страницу.
Положение вставленных изображений на этой странице определяется положением исходного изображения на соответствующей странице.
Если предоставленное изображение является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного изображения.
Если предоставленное изображение является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в изображение из исходной презентации. Если скопированное изображение-заполнитель пусто, в целевую презентацию ничего не вставляется.
// Copy an image between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Параметры
Имя | Тип | Описание |
---|---|---|
image | Image | Изображение, которое нужно скопировать и вставить. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
Вставляет изображение в верхний левый угол страницы с размером по умолчанию из указанного URL-адреса.
При вставке изображения оно извлекается из URL-адреса один раз, а копия сохраняется для отображения внутри презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.
Предоставленный URL-адрес должен быть общедоступным и иметь размер не более 2 КБ. Сам URL-адрес сохраняется вместе с изображением и отображается через Image.getSourceUrl()
.
Параметры
Имя | Тип | Описание |
---|---|---|
imageUrl | String | URL-адрес изображения. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
Вставляет изображение на страницу с указанным положением и размером из предоставленного URL-адреса.
При вставке изображения оно извлекается из URL-адреса один раз, а копия сохраняется для отображения внутри презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.
Предоставленный URL-адрес должен быть общедоступным и иметь размер не более 2 КБ. Сам URL-адрес сохраняется вместе с изображением и отображается через Image.getSourceUrl()
.
Чтобы сохранить пропорции изображения, изображение масштабируется и центрируется относительно предоставленного размера.
Параметры
Имя | Тип | Описание |
---|---|---|
imageUrl | String | URL-адрес изображения. |
left | Number | Горизонтальное положение изображения в пунктах, измеренное от левого верхнего угла страницы. |
top | Number | Вертикальное положение изображения в пунктах, измеренное от левого верхнего угла страницы. |
width | Number | Ширина изображения в точках. |
height | Number | Высота изображения в пунктах. |
Возвращаться
Image
— вставленное изображение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
Вставляет копию предоставленной Line
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a line between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Параметры
Имя | Тип | Описание |
---|---|---|
line | Line | Строка, которую нужно скопировать и вставить. |
Возвращаться
Line
— вставленная строка.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Вставляет на страницу линию, соединяющую два connection sites
. Два сайта подключения должны быть на этой странице.
// Insert a line in the first slide of the presentation connecting two shapes. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1]);
Параметры
Имя | Тип | Описание |
---|---|---|
lineCategory | LineCategory | Категория вставляемой строки. |
startConnectionSite | ConnectionSite | Место подключения, к которому должно быть подключено начало линии. |
endConnectionSite | ConnectionSite | Место соединения, к которому должен быть подключен конец линии. |
Возвращаться
Line
— вставленная строка.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Вставляет строку на страницу.
// Insert a line in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var startPoint = {left: 10, top: 10}; var endPoint = {left: 40, top: 40}; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top);
Параметры
Имя | Тип | Описание |
---|---|---|
lineCategory | LineCategory | Категория вставляемой строки. |
startLeft | Number | Горизонтальное положение начальной точки линии, измеренное в пунктах от левого верхнего угла страницы. |
startTop | Number | Вертикальное положение начальной точки линии, измеренное в пунктах от левого верхнего угла страницы. |
endLeft | Number | Горизонтальное положение конечной точки линии, измеренное в пунктах от левого верхнего угла страницы. |
endTop | Number | Вертикальное положение конечной точки линии, измеренное в пунктах от левого верхнего угла страницы. |
Возвращаться
Line
— вставленная строка.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
Вставляет копию предоставленного PageElement
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a page element between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Параметры
Имя | Тип | Описание |
---|---|---|
pageElement | PageElement | Элемент страницы, который необходимо скопировать и вставить. |
Возвращаться
PageElement
— вставленный элемент страницы.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
Вставляет копию предоставленной Shape
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a shape between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var 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
insertShape(shapeType)
Вставляет фигуру на страницу.
Фигура вставляется с размером по умолчанию в верхнем левом углу страницы.
// Insert a shape in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Параметры
Имя | Тип | Описание |
---|---|---|
shapeType | ShapeType | Тип фигуры для вставки. |
Возвращаться
Shape
— вставленная форма.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
Вставляет фигуру на страницу.
Параметры
Имя | Тип | Описание |
---|---|---|
shapeType | ShapeType | Тип фигуры для вставки. |
left | Number | Горизонтальное положение фигуры, измеряемое от верхнего левого угла страницы. |
top | Number | Вертикальное положение фигуры, измеряемое от верхнего левого угла страницы. |
width | Number | Ширина формы. |
height | Number | Высота формы. |
Возвращаться
Shape
— вставленная форма.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
Вставляет диаграмму Google Sheets на страницу.
Диаграмма вставляется с размером по умолчанию в верхнем левом углу страницы.
Вставленная диаграмма связана с исходной диаграммой Google Sheets, что позволяет ее обновлять. Другие соавторы могут видеть ссылку на исходную таблицу.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Параметры
Имя | Тип | Описание |
---|---|---|
sourceChart | EmbeddedChart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
Возвращаться
SheetsChart
— диаграмма, вставленная на страницу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart, left, top, width, height)
Вставляет диаграмму Google Sheets на страницу с указанным положением и размером.
Чтобы сохранить соотношение сторон диаграммы, диаграмма масштабируется и центрируется относительно предоставленного размера.
Вставленная диаграмма связана с исходной диаграммой Google Sheets, что позволяет ее обновлять. Другие соавторы могут видеть ссылку на исходную таблицу.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height);
Параметры
Имя | Тип | Описание |
---|---|---|
sourceChart | EmbeddedChart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
left | Number | Горизонтальное положение диаграммы в пунктах, измеренное от верхнего левого угла страницы. |
top | Number | Вертикальное положение диаграммы в пунктах, измеренное от верхнего левого угла страницы. |
width | Number | Ширина диаграммы в пунктах. |
height | Number | Высота диаграммы в пунктах. |
Возвращаться
SheetsChart
— диаграмма, вставленная на страницу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sheetsChart)
Вставляет копию предоставленного SheetsChart
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a sheets chart between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Параметры
Имя | Тип | Описание |
---|---|---|
sheetsChart | SheetsChart | Листы диаграммы, которые необходимо скопировать и вставить. |
Возвращаться
SheetsChart
— Вставленная диаграмма листов.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
Вставляет диаграмму Google Sheets в виде Image
на страницу.
Изображение диаграммы вставляется с размером по умолчанию в верхнем левом углу страницы.
Вставленное изображение диаграммы не связано с исходной диаграммой Google Sheets.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
Параметры
Имя | Тип | Описание |
---|---|---|
sourceChart | EmbeddedChart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
Возвращаться
Image
— вставленное изображение диаграммы на страницу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Вставляет диаграмму Google Sheets в виде Image
на страницу с указанным положением и размером.
Чтобы сохранить соотношение сторон изображения диаграммы, изображение масштабируется и центрируется относительно предоставленного размера.
Вставленное изображение диаграммы не связано с исходной диаграммой Google Sheets.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height);
Параметры
Имя | Тип | Описание |
---|---|---|
sourceChart | EmbeddedChart | Диаграмма в электронной таблице, которая будет вставлена на страницу. |
left | Number | Горизонтальное положение диаграммы в пунктах, измеренное от верхнего левого угла страницы. |
top | Number | Вертикальное положение диаграммы в пунктах, измеренное от верхнего левого угла страницы. |
width | Number | Ширина диаграммы в пунктах. |
height | Number | Высота диаграммы в пунктах. |
Возвращаться
Image
— вставленное изображение диаграммы на страницу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
Вставляет таблицу на страницу.
Таблица центрируется на странице с размером по умолчанию и равномерно распределенными строками и столбцами.
Параметры
Имя | Тип | Описание |
---|---|---|
numRows | Integer | Количество строк в таблице. |
numColumns | Integer | Количество столбцов в таблице. |
Возвращаться
Table
— вставленная таблица.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
Вставляет таблицу на страницу с указанным положением и размером.
Строки и столбцы равномерно распределены в созданной таблице.
Параметры
Имя | Тип | Описание |
---|---|---|
numRows | Integer | Количество строк в таблице. |
numColumns | Integer | Количество столбцов в таблице. |
left | Number | Горизонтальное положение таблицы, измеряемое от верхнего левого угла страницы. |
top | Number | Вертикальное положение таблицы, измеряемое от верхнего левого угла страницы. |
width | Number | Ширина стола. |
height | Number | Минимальная высота стола. Фактическая высота визуализируемой таблицы зависит от таких факторов, как размер шрифта текста. |
Возвращаться
Table
— вставленная таблица.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
Вставляет копию предоставленной Table
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a table between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var 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
insertTextBox(text)
Вставляет Shape
текстового поля, содержащую предоставленную строку, на страницу.
Форма текстового поля вставляется с размером по умолчанию в верхнем левом углу страницы.
// Insert text box with "Hello" on the first slide of presentation. var 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
insertTextBox(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. var 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
insertVideo(videoUrl)
Вставляет видео в верхний левый угол страницы с размером по умолчанию.
В настоящее время поддерживаются только видео YouTube.
Параметры
Имя | Тип | Описание |
---|---|---|
videoUrl | String | URL-адрес видео для вставки. |
Возвращаться
Video
— вставленное видео.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
Вставляет видео на страницу с указанным положением и размером.
В настоящее время поддерживаются только видео YouTube.
Параметры
Имя | Тип | Описание |
---|---|---|
videoUrl | String | URL-адрес видео для вставки. |
left | Number | Горизонтальное положение видео в пунктах, измеренное от верхнего левого угла страницы. |
top | Number | Вертикальное положение видео в пунктах, измеренное от верхнего левого угла страницы. |
width | Number | Ширина видео в пунктах. |
height | Number | Высота видео в пунктах. |
Возвращаться
Video
— вставленное видео.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
Вставляет копию предоставленного Video
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a video between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var 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
insertWordArt(wordArt)
Вставляет копию предоставленного объекта WordArt
на страницу.
Положение вставленного элемента на этой странице определяется по положению исходного элемента на соответствующей странице.
Если предоставленный элемент является заполнителем, копируемым из текущей презентации, свойства, которые наследуются от мастер-страниц или страниц макета, также наследуются для вставленного элемента.
Если предоставленный элемент является заполнителем, копируемым из другой презентации, свойства, унаследованные от эталонных страниц или страниц макета, копируются в элемент из исходной презентации.
// Copy a word art between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Параметры
Имя | Тип | Описание |
---|---|---|
wordArt | WordArt | Группа, которую нужно скопировать и вставить. |
Возвращаться
WordArt
— вставленное искусство слова.
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
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
replaceAllText(findText, replaceText)
Заменяет все вхождения текста, совпадающего с поисковым текстом, на замещающий текст. Поиск нечувствителен к регистру.
Параметры
Имя | Тип | Описание |
---|---|---|
findText | String | Текст, который нужно найти. |
replaceText | String | Текст для замены совпадающего текста. |
Возвращаться
Integer
— количество измененных вхождений
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Заменяет все вхождения текста, совпадающего с поисковым текстом, на замещающий текст.
Параметры
Имя | Тип | Описание |
---|---|---|
findText | String | Текст, который нужно найти. |
replaceText | String | Текст для замены совпадающего текста. |
matchCase | Boolean | Если true , поиск чувствителен к регистру; если false , поиск нечувствителен к регистру. |
Возвращаться
Integer
— количество измененных вхождений
Авторизация
Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
Выбирает Page
в активной презентации в качестве current page selection
и удаляет любой предыдущий выбор.
Сценарий может получить доступ только к выбору пользователя, запустившего сценарий, и только в том случае, если сценарий привязан к презентации.
// Select the first slide as the current page selection and replace any previous selection. var 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