Class Page

Страница

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

Методы

Метод Тип возврата Краткое описание
asLayout() Layout Возвращает страницу как макет.
asMaster() Master Возвращает страницу как главную.
asSlide() Slide Возвращает страницу в виде слайда.
getBackground() PageBackground Получает фон страницы.
getColorScheme() ColorScheme Получает ColorScheme связанную со страницей.
getGroups() Group[] Возвращает список объектов Group на странице.
getImages() Image[] Возвращает список объектов Image на странице.
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 Вставляет изображение в верхний левый угол страницы с размером по умолчанию из указанного BLOB-объекта изображения.
insertImage(blobSource, left, top, width, height) Image Вставляет изображение на страницу с заданным положением и размером из указанного BLOB-объекта изображения.
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 и удаляет любой предыдущий выбор.

Подробная документация

asLayout()

Возвращает страницу как макет.

Возвращаться

Layout — страница как макет.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asMaster()

Возвращает страницу как главную.

Возвращаться

Master — страница в качестве мастера.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asSlide()

Возвращает страницу в виде слайда.

Возвращаться

Slide — страница в виде слайда.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

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()

Возвращает список объектов Group на странице.

Возвращаться

Group[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getImages()

Возвращает список объектов Image на странице.

Возвращаться

Image[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLines()

Возвращает список объектов Line на странице.

Возвращаться

Line[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

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 , отображаемых на странице.

Возвращаться

PageElement[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageType()

Получает тип страницы.

Возвращаться

PageType — тип страницы.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType)

Возвращает объект-заполнитель PageElement для указанного PlaceholderType или null , если соответствующий заполнитель отсутствует.

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);

Параметры

Имя Тип Описание
placeholderType PlaceholderType

Возвращаться

PageElement

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • 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

Возвращаться

PageElement

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • 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);

Возвращаться

PageElement[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getShapes()

Возвращает список объектов Shape на странице.

Возвращаться

Shape[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSheetsCharts()

Возвращает список объектов SheetsChart на странице.

Возвращаться

SheetsChart[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTables()

Возвращает список объектов Table на странице.

Возвращаться

Table[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getVideos()

Возвращает список объектов Video на странице.

Возвращаться

Video[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWordArts()

Возвращает список объектов WordArt на странице.

Возвращаться

WordArt[]

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

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)

Вставляет изображение в верхний левый угол страницы с размером по умолчанию из указанного BLOB-объекта изображения.

При вставке изображения оно извлекается из 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)

Вставляет изображение на страницу с заданным положением и размером из указанного BLOB-объекта изображения.

Изображение извлекается из предоставленного 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 Таблиц. 

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 Таблиц. 

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