Class Master

Владелец

Мастер презентаций.

Мастер-шаблоны содержат все общие элементы страницы и общие свойства для набора макетов. Они выполняют три функции:

  • На шаблоне страницы содержатся фигуры-заполнители, отображающие стили текста и свойства по умолчанию, аналогичные тем, что используются на страницах, использующих этот шаблон.
  • Свойства главной страницы определяют общие свойства страницы, наследуемые ее макетами.
  • Все остальные фигуры на мастер-слайде отображаются на всех слайдах, использующих этот мастер-слайд, независимо от их расположения.

Методы

Метод Тип возвращаемого значения Краткое описание
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 |null Возвращает Page Element с заданным ID или null , если такового элемента не существует.
get Page Elements() Page Element[] Возвращает список объектов Page Element отображаемых на странице.
get Page Type() Page Type Получает тип страницы.
get Placeholder(placeholderType) Page Element |null Возвращает объект Page Element заполнителя для указанного Placeholder Type или null если соответствующий заполнитель отсутствует.
get Placeholder(placeholderType, placeholderIndex) Page Element |null Возвращает объект 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 Вставляет изображение в верхний левый угол страницы с размером по умолчанию из указанного блока изображений.
insert Image(blobSource, left, top, width, height) Image Вставляет на страницу изображение с заданными позициями и размерами из указанного блока изображений.
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 Таблиц на страницу.
insert Sheets Chart(sourceChart, left, top, width, height) Sheets Chart Вставляет диаграмму из Google Таблиц на страницу в заданном положении и размере.
insert Sheets Chart(sheetsChart) Sheets Chart Вставляет копию предоставленной Sheets Chart на страницу.
insert Sheets Chart As Image(sourceChart) Image Вставляет диаграмму из Google Таблиц в виде Image на страницу.
insert Sheets Chart As Image(sourceChart, left, top, width, height) Image Вставляет диаграмму из Google Таблиц в виде 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 на странице.

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

Group[]

Авторизация

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

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

get Images()

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

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

Image[]

Авторизация

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

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

get Layouts()

Получает макеты этого мастера.

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

Layout[]

Авторизация

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

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

get Lines()

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

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

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 с заданным ID или null , если такового элемента не существует.

Параметры

Имя Тип Описание
id String Идентификатор элемента страницы, который извлекается.

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

Page Element |null — Элемент страницы с заданным ID.

Авторизация

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

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

get Page Elements()

Возвращает список объектов Page Element отображаемых на странице.

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

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

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

Page Element |null

Авторизация

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

  • 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

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

Page Element |null

Авторизация

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

  • 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}`,
);

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

Page Element[]

Авторизация

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

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

get Shapes()

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

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

Shape[]

Авторизация

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

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

get Sheets Charts()

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

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

Sheets Chart[]

Авторизация

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

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

get Tables()

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

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

Table[]

Авторизация

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

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

get Videos()

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

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

Video[]

Авторизация

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

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

get Word Arts()

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

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

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 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 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 Таблиц на страницу.

Диаграмма вставляется в верхний левый угол страницы с размером по умолчанию.

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

Для сохранения пропорций диаграммы, она масштабируется и центрируется относительно заданного размера.

Вставленная диаграмма связана с исходной диаграммой в 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.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 Таблиц в виде Image на страницу.

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

Вставленное изображение диаграммы не связано с исходной диаграммой 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];
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 Таблиц в виде Image на страницу с заданным положением и размером.

Для сохранения пропорций изображения диаграммы, оно масштабируется и центрируется относительно заданного размера.

Вставленное изображение диаграммы не связано с исходной диаграммой 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.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