Эта страница переведена с помощью Cloud Translation API.

Class Image

Page Element представляющий изображение.

Методы

Метод	Тип возврата	Краткое описание
`align On Page(alignmentPosition)`	`Image`	Выравнивает элемент по указанному положению выравнивания на странице.
`bring Forward()`	`Image`	Перемещает элемент страницы вперед на один элемент.
`bring To Front()`	`Image`	Перемещает элемент страницы в начало страницы.
`duplicate()`	`Page Element`	Дублирует элемент страницы.
`get As(contentType)`	`Blob`	Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
`get Blob()`	`Blob`	Верните данные внутри этого изображения в виде большого двоичного объекта.
`get Border()`	`Border`	Возвращает `Border` изображения.
`get Connection Sites()`	`Connection Site[]`	Возвращает список `Connection Site` в элементе страницы или пустой список, если элемент страницы не имеет сайтов подключения.
`get Content Url()`	`String`	Получает URL-адрес изображения.
`get Description()`	`String`	Возвращает альтернативное текстовое описание элемента страницы.
`get Height()`	`Number`	Получает высоту элемента в пунктах, которая представляет собой высоту ограничивающей рамки элемента, когда элемент не вращается.
`get Inherent Height()`	`Number`	Возвращает собственную высоту элемента в пунктах.
`get Inherent Width()`	`Number`	Возвращает собственную ширину элемента в пунктах.
`get Left()`	`Number`	Возвращает горизонтальное положение элемента в пунктах, измеренное от верхнего левого угла страницы, когда элемент не вращается.
`get Link()`	`Link`	Возвращает `Link` или `null` , если ссылки нет.
`get Object Id()`	`String`	Возвращает уникальный идентификатор этого объекта.
`get Page Element Type()`	`Page Element Type`	Возвращает тип элемента страницы, представленный в виде перечисления `Page Element Type` .
`get Parent Group()`	`Group`	Возвращает группу, к которой принадлежит этот элемент страницы, или `null` если элемент не входит в группу.
`get Parent Page()`	`Page`	Возвращает страницу, на которой находится этот элемент страницы.
`get Parent Placeholder()`	`Page Element`	Возвращает родительский элемент страницы заполнителя.
`get Placeholder Index()`	`Integer`	Возвращает индекс изображения-заполнителя.
`get Placeholder Type()`	`Placeholder Type`	Возвращает тип заполнителя изображения или `Placeholder Type.NONE` если фигура не является заполнителем.
`get Rotation()`	`Number`	Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие вращения.
`get Source Url()`	`String`	Получает исходный URL-адрес изображения, если он доступен.
`get Title()`	`String`	Возвращает замещающий текстовый заголовок элемента страницы.
`get Top()`	`Number`	Получает вертикальное положение элемента в пунктах, измеренное от верхнего левого угла страницы, когда элемент не вращается.
`get Transform()`	`Affine Transform`	Возвращает преобразование элемента страницы.
`get Width()`	`Number`	Возвращает ширину элемента в пунктах, которая равна ширине ограничивающей рамки элемента, когда элемент не вращается.
`preconcatenate Transform(transform)`	`Image`	Предварительно объединяет предоставленное преобразование с существующим преобразованием элемента страницы.
`remove()`	`void`	Удаляет элемент страницы.
`remove Link()`	`void`	Удаляет `Link` .
`replace(blobSource)`	`Image`	Заменяет это изображение изображением, описанным объектом `Blob Source` .
`replace(blobSource, crop)`	`Image`	Заменяет это изображение изображением, описанным объектом `Image` , при необходимости обрезая изображение по размеру.
`replace(imageUrl)`	`Image`	Заменяет это изображение другим изображением, загруженным по указанному URL-адресу.
`replace(imageUrl, crop)`	`Image`	Заменяет это изображение другим изображением, загруженным по указанному URL-адресу, при необходимости обрезая изображение по размеру.
`scale Height(ratio)`	`Image`	Масштабирует высоту элемента в указанном соотношении.
`scale Width(ratio)`	`Image`	Масштабирует ширину элемента в указанном соотношении.
`select()`	`void`	Выбирает только `Page Element` в активной презентации и удаляет любой предыдущий выбор.
`select(replace)`	`void`	Выбирает `Page Element` в активной презентации.
`send Backward()`	`Image`	Отправляет элемент страницы назад на один элемент.
`send To Back()`	`Image`	Отправляет элемент страницы в конец страницы.
`set Description(description)`	`Image`	Устанавливает альтернативное текстовое описание элемента страницы.
`set Height(height)`	`Image`	Устанавливает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не вращается.
`set Left(left)`	`Image`	Устанавливает горизонтальное положение элемента в пунктах, измеряемое от верхнего левого угла страницы, когда элемент не вращается.
`set Link Slide(slideIndex)`	`Link`	Устанавливает `Link` на данный `Slide` используя индекс слайда, начинающийся с нуля.
`set Link Slide(slide)`	`Link`	Устанавливает `Link` на данный `Slide` , ссылка устанавливается по заданному идентификатору слайда.
`set Link Slide(slidePosition)`	`Link`	Устанавливает `Link` на данный `Slide` используя относительное положение слайда.
`set Link Url(url)`	`Link`	Устанавливает `Link` на данную непустую строку URL.
`set Rotation(angle)`	`Image`	Устанавливает угол поворота элемента по часовой стрелке вокруг его центра в градусах.
`set Title(title)`	`Image`	Устанавливает замещающий текстовый заголовок элемента страницы.
`set Top(top)`	`Image`	Устанавливает вертикальное положение элемента в пунктах, измеряемое от верхнего левого угла страницы, когда элемент не вращается.
`set Transform(transform)`	`Image`	Устанавливает преобразование элемента страницы с помощью предоставленного преобразования.
`set Width(width)`	`Image`	Устанавливает ширину элемента в пунктах, которая равна ширине ограничивающей рамки элемента, когда элемент не вращается.

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

`align On Page(alignmentPosition)`

Выравнивает элемент по указанному положению выравнивания на странице.

Параметры

Имя	Тип	Описание
`alignment Position`	`Alignment Position`	Позиция, по которой выравнивается этот элемент страницы на странице.

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

Image — этот элемент страницы для цепочки.

`bring Forward()`

Перемещает элемент страницы вперед на один элемент.

Элемент страницы не должен входить в группу.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`bring To Front()`

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

Элемент страницы не должен входить в группу.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`duplicate()`

Дублирует элемент страницы.

Дубликат элемента страницы размещается на той же странице в том же месте, что и оригинал.

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

Page Element — новый дубликат этого элемента страницы.

Авторизация

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

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

`get As(contentType)`

Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. Этот метод добавляет к имени файла соответствующее расширение, например «myfile.pdf». Однако предполагается, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.25.12.2014» становится «Список покупок.12.25.pdf».

Чтобы просмотреть ежедневные квоты на конверсии, см. Квоты для сервисов Google . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.

Параметры

Имя	Тип	Описание
`content Type`	`String`	Тип MIME, в который требуется преобразовать. Для большинства больших двоичных объектов единственным допустимым вариантом является `'application/pdf'` . Для изображений в формате BMP, GIF, JPEG или PNG также допустимо любое из `'image/bmp'` , `'image/gif'` , `'image/jpeg'` или `'image/png'` . Для документа Google Docs также допустимо использование `'text/markdown'` .

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

Blob — данные в виде большого двоичного объекта.

`get Blob()`

Верните данные внутри этого изображения в виде большого двоичного объекта.

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

Blob — данные изображения в виде blob.

`get Border()`

Возвращает Border изображения.

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

Border — Граница изображения.

Авторизация

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

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

`get Connection Sites()`

Возвращает список Connection Site в элементе страницы или пустой список, если элемент страницы не имеет сайтов подключения.

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

Connection Site[] — список сайтов подключения, который может быть пустым, если у этого элемента нет сайтов подключения.

Авторизация

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

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

`get Content Url()`

Получает URL-адрес изображения.

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

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

String

Авторизация

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

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

`get Description()`

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

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

String — описание альтернативного текста элемента страницы.

Авторизация

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

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

`get Height()`

Получает высоту элемента в пунктах, которая представляет собой высоту ограничивающей рамки элемента, когда элемент не вращается.

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

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

Number — собственная высота элемента страницы в пунктах или null , если элемент страницы не имеет высоты.

Авторизация

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

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

`get Inherent Height()`

Возвращает собственную высоту элемента в пунктах.

Преобразование элемента страницы происходит относительно его собственного размера. Используйте собственный размер в сочетании с преобразованием элемента, чтобы определить окончательный внешний вид элемента.

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

Number — собственная высота элемента страницы в пунктах или null , если элемент страницы не имеет высоты.

Авторизация

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

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

`get Inherent Width()`

Возвращает собственную ширину элемента в пунктах.

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

Number — собственная ширина элемента страницы в пунктах или null , если элемент страницы не имеет ширины.

Авторизация

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

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

`get Left()`

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

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

Number — горизонтальное положение этого элемента в пунктах, начиная с левого верхнего угла страницы.

Авторизация

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

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

`get Link()`

Возвращает Link или null , если ссылки нет.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

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

Link — Link или null , если ссылки нет.

Авторизация

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

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

Возвращает тип элемента страницы, представленный в виде перечисления Page Element Type .

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

Page Element Type — тип элемента страницы.

Авторизация

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

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

`get Parent Group()`

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

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

Group — группа, к которой принадлежит этот элемент страницы, или null .

Авторизация

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

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

`get Parent Page()`

Возвращает страницу, на которой находится этот элемент страницы.

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

Page — страница, на которой находится этот элемент.

Авторизация

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

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

`get Parent Placeholder()`

Возвращает родительский элемент страницы заполнителя. Возвращает null , если изображение не является заполнителем или не имеет родительского элемента.

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

Page Element — родительский элемент страницы заполнителя этого изображения или null , если это изображение не является заполнителем или не имеет родительского элемента.

Авторизация

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

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

`get Placeholder Index()`

Возвращает индекс изображения-заполнителя. Если два или более изображений-заполнителей на одной странице относятся к одному типу, каждое из них имеет уникальное значение индекса. Возвращает значение null если изображение не является заполнителем.

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

Integer — индекс заполнителя этого изображения или null , если изображение не является заполнителем.

Авторизация

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

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

`get Placeholder Type()`

Возвращает тип заполнителя изображения или Placeholder Type.NONE если фигура не является заполнителем.

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

Placeholder Type — тип заполнителя этого изображения.

Авторизация

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

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

`get Rotation()`

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

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

Number — Угол поворота в градусах от 0 (включительно) до 360 (не включая).

Авторизация

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

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

`get Source Url()`

Получает исходный URL-адрес изображения, если он доступен.

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

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

String — URL-адрес изображения или null , если изображение не имеет исходного URL-адреса.

Авторизация

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

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

`get Title()`

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

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

String — замещающий текстовый заголовок элемента страницы.

Авторизация

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

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

`get Top()`

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

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

Number — вертикальное положение этого элемента в пунктах, начиная с левого верхнего угла страницы.

Авторизация

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

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

`get Transform()`

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

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

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

Affine Transform — преобразование элемента страницы.

Авторизация

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

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

`get Width()`

Возвращает ширину элемента в пунктах, которая равна ширине ограничивающей рамки элемента, когда элемент не вращается.

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

Number — собственная ширина элемента страницы в пунктах или null , если элемент страницы не имеет ширины.

Авторизация

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

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

`preconcatenate Transform(transform)`

Предварительно объединяет предоставленное преобразование с существующим преобразованием элемента страницы.

newTransform = argument * existingTransform;

Например, чтобы переместить элементы страницы на 36 пунктов влево:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Вы также можете заменить преобразование элемента страницы на set Transform(transform) .

Параметры

Имя	Тип	Описание
`transform`	`Affine Transform`	Преобразование для предварительного объединения с преобразованием этого элемента страницы.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`remove()`

Удаляет элемент страницы.

Если после операции удаления Group содержит только один элемент страницы или не содержит ни одного элемента, сама группа также удаляется.

Если Page Element -заполнителя удаляется из мастера или макета, все пустые наследуемые заполнители также удаляются.

Авторизация

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

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

`remove Link()`

Удаляет Link .

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replace(blobSource)`

Заменяет это изображение изображением, описанным объектом Blob Source .

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

Чтобы сохранить соотношение сторон изображения, оно масштабируется и центрируется относительно размера существующего изображения.

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

Параметры

Имя	Тип	Описание
`blob Source`	`Blob Source`	Данные изображения.

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

Image — Это Image после замены.

Авторизация

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

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

`replace(blobSource, crop)`

Заменяет это изображение изображением, описанным объектом Image , при необходимости обрезая изображение по размеру.

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(driveImage, true);

Параметры

Имя	Тип	Описание
`blob Source`	`Blob Source`	Данные изображения.
`crop`	`Boolean`	Если `true` , изображение обрезается в соответствии с размером существующего изображения. В противном случае изображение масштабируется и центрируется.

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

Image — Это Image после замены.

Авторизация

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

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

`replace(imageUrl)`

Заменяет это изображение другим изображением, загруженным по указанному URL-адресу.

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

Предоставленный URL-адрес должен быть общедоступным и иметь размер не более 2 КБ. Сам URL-адрес сохраняется вместе с изображением и предоставляется с помощью get Source Url() .

Параметры

Имя	Тип	Описание
`image Url`	`String`	URL-адрес для загрузки изображения.

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

Image — Это Image после замены.

Авторизация

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

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

`replace(imageUrl, crop)`

Заменяет это изображение другим изображением, загруженным по указанному URL-адресу, при необходимости обрезая изображение по размеру.

Предоставленный URL-адрес не должен превышать 2 КБ.

Параметры

Имя	Тип	Описание
`image Url`	`String`	URL-адрес для загрузки изображения.
`crop`	`Boolean`	Если `true` , изображение обрезается в соответствии с размером существующего изображения. В противном случае изображение масштабируется и центрируется.

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

Image — Это Image после замены.

Авторизация

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

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

`scale Height(ratio)`

Масштабирует высоту элемента в указанном соотношении. Высота элемента — это высота его ограничивающей рамки, когда элемент не вращается.

Параметры

Имя	Тип	Описание
`ratio`	`Number`	Коэффициент масштабирования высоты этого элемента страницы.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`scale Width(ratio)`

Масштабирует ширину элемента в указанном соотношении. Ширина элемента — это ширина его ограничивающей рамки, когда элемент не вращается.

Параметры

Имя	Тип	Описание
`ratio`	`Number`	Коэффициент масштабирования ширины этого элемента страницы.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`select()`

Выбирает только Page Element в активной презентации и удаляет любой предыдущий выбор. Это то же самое, что вызвать select(replace) с true .

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

Это устанавливает родительскую Page Page Element в качестве current page selection .

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Авторизация

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

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

`select(replace)`

Выбирает Page Element в активной презентации.

Передайте true этому методу, чтобы выбрать только Page Element и удалить любой предыдущий выбор. Это также устанавливает родительскую Page Page Element в качестве current page selection .

Передайте false , чтобы выбрать несколько объектов Page Element . Объекты Page Element должны находиться на одной Page .

При выборе элемента страницы с использованием параметра false должны быть выполнены следующие условия:

Родительская Page объекта Page Element должна быть current page selection .
Не должно быть выбрано несколько объектов Page .

Чтобы убедиться в этом, предпочтительным подходом является сначала выбрать родительскую Page с помощью Page.selectAsCurrentPage() , а затем выбрать элементы страницы на этой странице.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Параметры

Имя	Тип	Описание
`replace`	`Boolean`	Если `true` , выбор заменяет любой предыдущий выбор; в противном случае выделение добавляется к любому предыдущему выделению.

Авторизация

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

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

`send Backward()`

Отправляет элемент страницы назад на один элемент.

Элемент страницы не должен входить в группу.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`send To Back()`

Отправляет элемент страницы в конец страницы.

Элемент страницы не должен входить в группу.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`set Description(description)`

Устанавливает альтернативное текстовое описание элемента страницы.

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

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Параметры

Имя	Тип	Описание
`description`	`String`	Строка, для которой необходимо задать замещающее текстовое описание.

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

Image — этот элемент страницы.

Авторизация

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

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

`set Height(height)`

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

Параметры

Имя	Тип	Описание
`height`	`Number`	Новая высота этого элемента страницы, которую нужно установить, в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`set Left(left)`

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

Параметры

Имя	Тип	Описание
`left`	`Number`	Новое горизонтальное положение, которое необходимо установить, в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`set Link Slide(slideIndex)`

Устанавливает Link на данный Slide используя индекс слайда, начинающийся с нуля.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Параметры

Имя	Тип	Описание
`slide Index`	`Integer`	Индекс слайда, начинающийся с нуля.

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

Link — установленная Link .

Авторизация

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

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

`set Link Slide(slide)`

Устанавливает Link на данный Slide , ссылка устанавливается по заданному идентификатору слайда.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Параметры

Имя	Тип	Описание
`slide`	`Slide`	`Slide` на который будет сделана ссылка.

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

Link — установленная Link .

Авторизация

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

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

`set Link Slide(slidePosition)`

Устанавливает Link на данный Slide используя относительное положение слайда.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Параметры

Имя	Тип	Описание
`slide Position`	`Slide Position`	Относительное `Slide Position` .

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

Link — установленная Link .

Авторизация

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

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

`set Link Url(url)`

Устанавливает Link на данную непустую строку URL.

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Параметры

Имя	Тип	Описание
`url`	`String`	Строка URL-адреса.

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

Link — установленная Link .

Авторизация

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

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

`set Rotation(angle)`

Устанавливает угол поворота элемента по часовой стрелке вокруг его центра в градусах.

Параметры

Имя	Тип	Описание
`angle`	`Number`	Новый угол поворота по часовой стрелке, который нужно установить, в градусах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`set Title(title)`

Устанавливает замещающий текстовый заголовок элемента страницы.

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

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Параметры

Имя	Тип	Описание
`title`	`String`	Строка, в которой будет задан замещающий текстовый заголовок.

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

Image — этот элемент страницы.

Авторизация

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

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

`set Top(top)`

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

Параметры

Имя	Тип	Описание
`top`	`Number`	Новое вертикальное положение, которое необходимо установить, в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

`set Transform(transform)`

Устанавливает преобразование элемента страницы с помощью предоставленного преобразования.

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

Обновление преобразования элемента страницы, находящегося в группе, изменяет только преобразование этого элемента страницы; это не влияет на преобразования группы или других элементов страницы в группе.

Подробную информацию о том, как преобразования влияют на внешний вид элементов страницы, см. в разделе get Transform() .

Параметры

Имя	Тип	Описание
`transform`	`Affine Transform`	Преобразование, установленное для этого элемента страницы.

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

Image — этот элемент для цепочки.

Авторизация

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

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

`set Width(width)`

Устанавливает ширину элемента в пунктах, которая равна ширине ограничивающей рамки элемента, когда элемент не вращается.

Параметры

Имя	Тип	Описание
`width`	`Number`	Новая ширина этого элемента страницы, которую нужно установить, в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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