Class SheetsChart

ЛистыДиаграмма

PageElement представляющий связанную диаграмму, встроенную из Google Sheets.

Методы

Метод Тип возврата Краткое описание
alignOnPage(alignmentPosition) SheetsChart Выравнивает элемент по указанному положению выравнивания на странице.
asImage() Image Возвращает диаграмму как изображение или null если диаграмма не является внедренным изображением.
bringForward() SheetsChart Перемещает элемент страницы вперед на один элемент.
bringToFront() SheetsChart Перемещает элемент страницы в начало страницы.
duplicate() PageElement Дублирует элемент страницы.
getChartId() Integer Получает идентификатор конкретной диаграммы во встроенной электронной таблице Google Sheets.
getConnectionSites() ConnectionSite[] Возвращает список ConnectionSite в элементе страницы или пустой список, если элемент страницы не имеет сайтов подключения.
getDescription() String Возвращает альтернативное текстовое описание элемента страницы.
getEmbedType() SheetsChartEmbedType Возвращает тип внедрения диаграммы Таблиц.
getHeight() Number Получает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не вращается.
getInherentHeight() Number Возвращает собственную высоту элемента в пунктах.
getInherentWidth() Number Возвращает собственную ширину элемента в пунктах.
getLeft() Number Возвращает горизонтальное положение элемента в пунктах, измеренное от верхнего левого угла страницы, когда элемент не вращается.
getLink() Link Возвращает Link или null , если ссылки нет.
getObjectId() String Возвращает уникальный идентификатор этого объекта.
getPageElementType() PageElementType Возвращает тип элемента страницы, представленный в виде перечисления PageElementType .
getParentGroup() Group Возвращает группу, к которой принадлежит этот элемент страницы, или null если элемент не входит в группу.
getParentPage() Page Возвращает страницу, на которой находится этот элемент страницы.
getRotation() Number Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие вращения.
getSpreadsheetId() String Получает идентификатор электронной таблицы Google Sheets, содержащей исходную диаграмму.
getTitle() String Возвращает замещающий текстовый заголовок элемента страницы.
getTop() Number Получает вертикальное положение элемента в точках, измеренное от верхнего левого угла страницы, когда элемент не вращается.
getTransform() AffineTransform Возвращает преобразование элемента страницы.
getWidth() Number Возвращает ширину элемента в пунктах, которая равна ширине ограничивающей рамки элемента, когда элемент не вращается.
preconcatenateTransform(transform) SheetsChart Предварительно объединяет предоставленное преобразование с существующим преобразованием элемента страницы.
refresh() void Обновляет диаграмму, заменяя ее последней версией диаграммы из Google Таблиц.
remove() void Удаляет элемент страницы.
removeLink() void Удаляет Link .
scaleHeight(ratio) SheetsChart Масштабирует высоту элемента в указанном соотношении.
scaleWidth(ratio) SheetsChart Масштабирует ширину элемента в указанном соотношении.
select() void Выбирает только PageElement в активной презентации и удаляет любой предыдущий выбор.
select(replace) void Выбирает PageElement в активной презентации.
sendBackward() SheetsChart Отправляет элемент страницы назад на один элемент.
sendToBack() SheetsChart Отправляет элемент страницы в конец страницы.
setDescription(description) SheetsChart Устанавливает альтернативное текстовое описание элемента страницы.
setHeight(height) SheetsChart Устанавливает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не вращается.
setLeft(left) SheetsChart Устанавливает горизонтальное положение элемента в пунктах, измеряемое от верхнего левого угла страницы, когда элемент не вращается.
setLinkSlide(slideIndex) Link Устанавливает Link на данный Slide используя индекс слайда, начинающийся с нуля.
setLinkSlide(slide) Link Устанавливает Link на данный Slide , ссылка устанавливается по заданному идентификатору слайда.
setLinkSlide(slidePosition) Link Устанавливает Link на данный Slide используя относительное положение слайда.
setLinkUrl(url) Link Устанавливает Link на данную непустую строку URL.
setRotation(angle) SheetsChart Устанавливает угол поворота элемента по часовой стрелке вокруг его центра в градусах.
setTitle(title) SheetsChart Устанавливает замещающий текстовый заголовок элемента страницы.
setTop(top) SheetsChart Устанавливает вертикальное положение элемента в пунктах, измеряемое от верхнего левого угла страницы, когда элемент не вращается.
setTransform(transform) SheetsChart Устанавливает преобразование элемента страницы с помощью предоставленного преобразования.
setWidth(width) SheetsChart Устанавливает ширину элемента в пунктах, которая равна ширине ограничивающей рамки элемента, когда элемент не вращается.

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

alignOnPage(alignmentPosition)

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

Параметры

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

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

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


asImage()

Возвращает диаграмму как изображение или null если диаграмма не является внедренным изображением.

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

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

Авторизация

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

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

bringForward()

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

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

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

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

Авторизация

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

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

bringToFront()

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

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

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

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

Авторизация

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

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

duplicate()

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

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

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

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

Авторизация

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

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

getChartId()

Получает идентификатор конкретной диаграммы во встроенной электронной таблице Google Sheets.

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

Integer — идентификатор встроенной диаграммы.

Авторизация

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

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

getConnectionSites()

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

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

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

Авторизация

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

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

getDescription()

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

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

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

Авторизация

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

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

getEmbedType()

Возвращает тип внедрения диаграммы Таблиц.

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

SheetsChartEmbedType — тип внедрения этой диаграммы.

Авторизация

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

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

getHeight()

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

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

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

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

Авторизация

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

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

getInherentHeight()

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

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

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

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

Авторизация

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

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

getInherentWidth()

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

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

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

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

Авторизация

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

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

getLeft()

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

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

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

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

LinkLink или null , если ссылки нет.

Авторизация

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

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

getObjectId()

Возвращает уникальный идентификатор этого объекта. Идентификаторы объектов, используемые страницами и элементами страниц, используют одно и то же пространство имен.

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

String — уникальный идентификатор этого объекта.

Авторизация

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

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

getPageElementType()

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

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

PageElementType — Тип элемента страницы.

Авторизация

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

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

getParentGroup()

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

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

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

Авторизация

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

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

getParentPage()

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

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

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

Авторизация

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

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

getRotation()

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

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

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

Авторизация

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

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

getSpreadsheetId()

Получает идентификатор электронной таблицы Google Sheets, содержащей исходную диаграмму.

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

String — идентификатор электронной таблицы, содержащей исходную диаграмму.

Авторизация

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

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

getTitle()

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

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

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

Авторизация

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

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

getTop()

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

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

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

Авторизация

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

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

getTransform()

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

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

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

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

Авторизация

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

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

getWidth()

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

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

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

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

Авторизация

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform;

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

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

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

Параметры

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

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

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

Авторизация

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

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

refresh()

Обновляет диаграмму, заменяя ее последней версией диаграммы из Google Таблиц. Если диаграмма уже обновлена, никаких изменений в диаграмме в презентации не вносится.

Авторизация

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

  • https://www.googleapis.com/auth/spreadsheets.readonly

remove()

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

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

Если заполнитель PageElement удаляется из шаблона или макета, все пустые наследуемые заполнители также удаляются.

Авторизация

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

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

Удаляет Link .

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

scaleHeight(ratio)

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

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

Параметры

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

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

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

Авторизация

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

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

scaleWidth(ratio)

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

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

Параметры

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

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

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

Авторизация

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

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

select()

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

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

Это устанавливает родительскую Page PageElement в качестве 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)

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

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

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

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

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

  1. Родительская Page объекта PageElement должна быть 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

sendBackward()

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

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

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

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

Авторизация

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

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

sendToBack()

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

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

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

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

Авторизация

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

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

setDescription(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 Строка, для которой необходимо задать замещающее текстовое описание.

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

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

Авторизация

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

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

setHeight(height)

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

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

Параметры

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

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

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

Авторизация

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

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

setLeft(left)

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

Параметры

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

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

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

Авторизация

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

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

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

Параметры

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

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

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

Авторизация

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

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

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

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

Параметры

Имя Тип Описание
slidePosition SlidePosition Относительное SlidePosition .

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

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

Авторизация

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

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

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

setRotation(angle)

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

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

Параметры

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

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

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

Авторизация

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

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

setTitle(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 Строка, в которой будет задан замещающий текстовый заголовок.

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

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

Авторизация

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

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

setTop(top)

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

Параметры

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

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

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

Авторизация

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

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

setTransform(transform)

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

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

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

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

Параметры

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

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

SheetsChart — этот элемент для связывания.

Авторизация

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

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

setWidth(width)

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

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

Параметры

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

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

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

Авторизация

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

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