Class Image

Изображение

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

Методы

Метод Тип возвращаемого значения Краткое описание
align On Page(alignmentPosition) Image Выравнивает элемент по указанному положению на странице.
bring Forward() Image Перемещает элемент страницы на один элемент вперед по странице.
bring To Front() Image Выводит элемент страницы на передний план страницы.
duplicate() Page Element Дублирует элемент страницы.
get As(contentType) Blob Возвращает данные, содержащиеся в этом объекте, в виде двоичных данных (blob), преобразованных в указанный тип содержимого.
get Blob() Blob Возвращает данные, содержащиеся в этом изображении, в виде объекта типа "blob".
get Border() Border Возвращает Border изображения.
get Connection Sites() Connection Site[] Возвращает список Connection Site ) для элемента страницы или пустой список, если элемент страницы не содержит сайтов подключения.
get Content Url() String Получает URL-адрес изображения.
get Description() String Возвращает описание альтернативного текста элемента страницы.
get Height() Number|null Получает высоту элемента в точках, которая равна высоте ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
get Inherent Height() Number|null Возвращает собственную высоту элемента в пунктах.
get Inherent Width() Number|null Возвращает внутреннюю ширину элемента в пунктах.
get Left() Number Возвращает горизонтальное положение элемента в точках, измеренное от верхнего левого угла страницы, если элемент не имеет поворота.
get Link() Link |null Возвращает Link или null , если ссылки нет.
get Object Id() String Возвращает уникальный идентификатор данного объекта.
get Page Element Type() Page Element Type Возвращает тип элемента страницы, представленный в виде перечисления Page Element Type .
get Parent Group() Group |null Возвращает группу, к которой принадлежит данный элемент страницы, или null если элемент не входит в группу.
get Parent Page() Page Возвращает страницу, на которой находится данный элемент страницы.
get Parent Placeholder() Page Element |null Возвращает родительский элемент страницы для заполнителя.
get Placeholder Index() Integer|null Возвращает индекс изображения-заполнителя.
get Placeholder Type() Placeholder Type Возвращает тип заполнителя изображения или Placeholder Type.NONE если фигура не является заполнителем.
get Rotation() Number Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие поворота.
get Source Url() String|null Получает URL-адрес источника изображения, если он доступен.
get Title() String Возвращает альтернативный текст заголовка элемента страницы.
get Top() Number Получает вертикальное положение элемента в точках, измеренное от верхнего левого угла страницы, когда элемент не имеет поворота.
get Transform() Affine Transform Возвращает преобразование элемента страницы.
get Width() Number|null Возвращает ширину элемента в пунктах, которая соответствует ширине ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
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 Задает преобразование элемента страницы с заданным параметром transform.
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)

Возвращает данные, содержащиеся в этом объекте, в виде двоичных данных (blob), преобразованных в указанный тип содержимого.

Параметры

Имя Тип Описание
content Type String MIME-тип, в который следует преобразовать.

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

Blob — Данные в виде двоичных данных (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 — Внутренняя высота элемента страницы в пунктах, или null если высота элемента страницы не задана.

Авторизация

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

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

get Inherent Height()

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

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

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

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

Авторизация

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

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

get Inherent Width()

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

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

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

Number|null — Внутренняя ширина элемента страницы в пунктах, или 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

Возвращает 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 |null — 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 — Группа, к которой принадлежит этот элемент страницы, или 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 — Родительский элемент страницы для этого изображения-заполнителя, или null если это изображение не является заполнителем или не имеет родителя.

Авторизация

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

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

get Placeholder Index()

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

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

Integer|null — Индекс заполнителя этого изображения или 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|null — 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 — Внутренняя ширина элемента страницы в пунктах, или 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(),
);

Вы также можете заменить свойство transform элемента страницы с помощью 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

Удаляет 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 , при необходимости обрезая изображение по размеру.

При вставке изображения оно один раз загружается из 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');
// 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-адресу один раз, и копия сохраняется для отображения в презентации. Размер изображений не должен превышать 50 МБ, разрешение — 25 мегапикселей, формат — PNG, JPEG или GIF.

Размер предоставленного 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 должны быть соблюдены следующие условия:

  1. Родительской Page объекта « Page Element должна быть current page selection .
  2. Не должно быть выбрано несколько объектов 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)

Задает преобразование элемента страницы с заданным параметром 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