Модуль Google Apps Script

Функции, привязанные к конкретным сервисам Google Apps Script: Таблицы, Презентации, Admin SDK, Диск, Документы, Формы, сетевые запросы и встроенные классы интерфейса.

Пометка New означает функцию, добавленную в последнем выпуске; пометка Deprecated — функцию, которую планируется удалить в одном из будущих выпусков.

Базовые методы

Общие помощники, которыми пользуются остальные модули Google Apps Script ниже.

Функция	Возвращает	Краткое описание
`getByteSize`	`Number`	Возвращает длину строки в кодовых единицах.
`getTriggerById` New	`Trigger \\| null`	Находит триггер проекта по идентификатору.

Методы Admin SDK Directory

Помощники для сервиса Admin SDK Directory.

Функция	Возвращает	Краткое описание
`isAdmin`	`Boolean`	Сообщает, является ли текущий пользователь администратором Workspace.
`nonAdmin` New	`Boolean`	Сообщает, что текущий пользователь не является администратором Workspace.
`requireAdmin` New	`void`	Прерывает вызов, если текущий пользователь не администратор Workspace.

Методы Google Диска

Функция	Возвращает	Краткое описание
`createFolder` New	`Folder`	Создаёт путь папок на Диске, переиспользуя уже существующие папки.

Методы Google Документов

Помощники для Google Документов. Пока не реализованы. Будем рады вкладу — смотрите Contributing.

Методы Google Форм

Помощники для Google Форм. Пока не реализованы. Будем рады вкладу — смотрите Contributing.

Методы Google Таблиц

Помощники для чтения, записи и проверки данных Google Таблиц: работа со строками и столбцами, разбор нотации A1, сравнение GridRange и проверки типов для объектов Sheet, Spreadsheet и Range.

Функция	Возвращает	Краткое описание
`appendColumn`	`Sheet`	Добавляет один столбец после последнего столбца с данными.
`appendColumns`	`Sheet`	Добавляет столбцы после последнего столбца с данными.
`appendRow`	`Sheet`	Добавляет одну строку после последней строки с данными.
`appendRows`	`Sheet`	Добавляет строки после последней строки с данными.
`clearColumnsByConditional` New	`Number`	Очищает столбцы, выбранные предикатом, не удаляя сами столбцы.
`clearRowsByConditional` New	`Number`	Очищает строки, выбранные предикатом, не удаляя сами строки.
`convertRichTextToHtml`	`String`	Преобразует форматированное значение ячейки в HTML.
`deleteColumnsByConditional` New	`Number`	Удаляет столбцы, выбранные предикатом.
`deleteRowsByConditional` New	`Number`	Удаляет строки, выбранные предикатом.
`doGridRangesIntersect`	`Boolean`	Сообщает, пересекаются ли два диапазона хотя бы в одной ячейке.
`extractRangeFromA1Notation` New	`String \\| null`	Извлекает часть с диапазоном из нотации A1.
`extractSheetNameFromA1Notation`	`String \\| null`	Извлекает имя листа из нотации A1.
`getColumnIndexByLetter`	`Number \\| null`	Преобразует букву столбца в его индекс, считая от нуля.
`getColumnLetterByIndex`	`String`	Преобразует индекс столбца, считая от нуля, в его букву.
`getColumnLetterByPosition`	`String`	Преобразует позицию столбца, считая от единицы, в его букву.
`getColumnPositionByLetter`	`Number \\| null`	Преобразует букву столбца в его позицию, считая от единицы.
`getNamedRangeByName` New	`NamedRange \\| null`	Находит именованный диапазон по имени.
`getSchema` New	`SheetSchema \\| null`	Возвращает схему листа — сохранённую или выведенную из его содержимого.
`getSheetById`	`Sheet` \\| null	Находит лист по идентификатору.
`getSheetByIndex`	`Sheet` \\| null	Находит лист по его позиции в таблице.
`getValues` New	`Array`	Читает строки листа, фильтруя, преобразуя и разбивая на страницы за один вызов.
`highlightHtml`	`String`	Раскрашивает HTML в диапазоне как исходный код.
`insertSchema` New	`Sheet`	Сохраняет схему на листе и применяет то, что она описывает.
`isCellGridRange`	`Boolean`	Проверяет, является ли значение диапазоном из одной ячейки.
`isGridRangeContainedIn`	`Boolean`	Проверяет, лежит ли один диапазон целиком внутри другого.
`isGridRangeSameDimensions`	`Boolean`	Проверяет, совпадают ли два диапазона по высоте и ширине.
`isRange`	`Boolean`	Проверяет, является ли значение диапазоном.
`isRichTextValue`	`Boolean`	Проверяет, является ли значение форматированным текстом.
`isSheet`	`Boolean`	Проверяет, является ли значение листом.
`isSpreadsheet`	`Boolean`	Проверяет, является ли значение таблицей.
`isTextStyle`	`Boolean`	Проверяет, является ли значение стилем текста.
`isValidSheetId`	`Boolean`	Проверяет, является ли значение идентификатором листа.
`isValidSheetName`	`Boolean`	Проверяет, является ли значение именем листа.
`isValidSpreadsheetId`	`Boolean`	Проверяет, является ли значение идентификатором таблицы.
`nonCellGridRange` New	`Boolean`	Проверяет, что значение не является диапазоном из одной ячейки.
`nonGridRangeContainedIn` New	`Boolean`	Проверяет, что один диапазон не лежит целиком внутри другого.
`nonGridRangeSameDimensions` New	`Boolean`	Проверяет, различаются ли два диапазона по высоте или ширине.
`nonRange`	`Boolean`	Проверяет, что значение не является диапазоном.
`nonRichTextValue` New	`Boolean`	Проверяет, что значение не является форматированным текстом.
`nonSheet`	`Boolean`	Проверяет, что значение не является листом.
`nonSpreadsheet` New	`Boolean`	Проверяет, что значение не является таблицей.
`nonTextStyle` New	`Boolean`	Проверяет, что значение не является стилем текста.
`nonValidSheetId` New	`Boolean`	Проверяет, что значение не является идентификатором листа.
`nonValidSheetName` New	`Boolean`	Проверяет, что значение не является именем листа.
`nonValidSpreadsheetId` New	`Boolean`	Проверяет, что значение не является идентификатором таблицы.
`parseA1Notation` New	`GridRange`	Разбирает нотацию A1 в диапазон `GridRange`.
`parseA1Notations` New	`GridRange[]`	Разбирает список нотаций A1, перечисленных через запятую.
`prependColumn` New	`Sheet`	Вставляет один столбец перед данными — на листе или у диапазона.
`prependColumns` New	`Sheet`	Вставляет столбцы перед данными — на листе или у диапазона.
`prependRow`	`Sheet`	Вставляет одну строку перед данными — на листе или у диапазона.
`prependRows`	`Sheet`	Вставляет строки перед данными — на листе или у диапазона.
`removeSchema` New	`Boolean`	Удаляет схему, сохранённую на листе.
`requireCellGridRange` New	`GridRange`	Возвращает значение как диапазон из одной ячейки или выбрасывает исключение.
`requireGridRangeContainedIn` New	`GridRange`	Возвращает диапазон, убедившись, что он лежит внутри другого, иначе бросает исключение.
`requireGridRangeSameDimensions` New	`void`	Возвращает диапазон, убедившись, что размеры совпадают, иначе бросает исключение.
`requireRange`	`Range`	Возвращает значение как диапазон или выбрасывает исключение.
`requireRichTextValue` New	`RichTextValue`	Возвращает значение как форматированный текст или выбрасывает исключение.
`requireSheet`	`Sheet`	Возвращает значение как лист или выбрасывает исключение.
`requireSpreadsheet` New	`Spreadsheet`	Возвращает значение как таблицу или выбрасывает исключение.
`requireTextStyle` New	`TextStyle`	Возвращает значение как стиль текста или выбрасывает исключение.
`requireValidSheetId` New	`Number`	Возвращает значение как идентификатор листа или выбрасывает исключение.
`requireValidSheetName` New	`String`	Возвращает значение как имя листа или выбрасывает исключение.
`requireValidSpreadsheetId` New	`String`	Возвращает значение как идентификатор таблицы или выбрасывает исключение.
`sortSheets`	`void`	Переупорядочивает вкладки таблицы.
`toA1Notation`	`String`	Записывает диапазон `GridRange` в нотации A1.
`updateFormulas` New	`Number`	Переписывает формулы на листе.
`updateSheetNameInA1Notation` New	`String`	Заменяет имя листа в нотации A1, сохраняя диапазон.

Методы Google Презентаций

Помощники для Google Презентаций: поиск слайдов и их позиций, преобразование Markdown в RichTextRun, поиск с заменой и проверки типов для объектов Presentation и Slide.

Функция	Возвращает	Краткое описание
`convertMarkdownToRichText` New	`RichTextRun[]`	Превращает небольшое подмножество Markdown в форматированные фрагменты текста.
`convertRichTextToMarkdown` New	`String`	Превращает стилизованные фрагменты текста обратно в Markdown.
`findReplaceAllTextInSlide` New	`Number`	Заменяет все вхождения текста на одном слайде.
`getSlideByIndex` New	`Slide` \\|`null`	Находит слайд на заданной позиции — в презентации или в активной.
`getSlideIndex` New	`Number \\| null`	Находит позицию слайда — в презентации или в активной.
`isPresentation` New	`Boolean`	Проверяет, является ли значение презентацией.
`isSlide` New	`Boolean`	Проверяет, является ли значение слайдом.
`isValidPresentationId` New	`Boolean`	Проверяет, является ли значение идентификатором презентации.
`isValidSlideId` New	`Boolean`	Проверяет, является ли значение идентификатором слайда.
`nonPresentation` New	`Boolean`	Проверяет, что значение не является презентацией.
`nonSlide` New	`Boolean`	Проверяет, что значение не является слайдом.
`nonValidPresentationId` New	`Boolean`	Проверяет, что значение не является идентификатором презентации.
`nonValidSlideId` New	`Boolean`	Проверяет, что значение не является идентификатором слайда.
`requirePresentation` New	`Presentation`	Возвращает значение как презентацию или выбрасывает исключение.
`requireSlide` New	`Slide`	Возвращает значение как слайд или выбрасывает исключение.
`requireValidPresentationId` New	`String`	Возвращает значение как идентификатор презентации или выбрасывает исключение.
`requireValidSlideId` New	`String`	Возвращает значение как идентификатор слайда или выбрасывает исключение.

Сетевые методы

Помощники для сетевых операций — например, для проверки токенов запроса.

Функция	Возвращает	Краткое описание
`requireValidToken` New	`String`	Возвращает токен, если он совпал с одним из разрешённых ключей, иначе бросает исключение.

Методы интерфейса

Помощники для того, что видит пользователь, — проверки типов Ui, HtmlOutput и TextOutput, — а также проверки зависимостей: репозиториев и сервисов, которыми пользуются веб-приложения.

Функция	Возвращает	Краткое описание
`checkMultipleAccount`	`Boolean`	Сообщает, что скрипт выполняется от другого аккаунта, чем тот, что его запустил.
`isHtmlOutput`	`Boolean`	Проверяет, является ли значение объектом HtmlOutput.
`isTextOutput`	`Boolean`	Проверяет, является ли значение объектом TextOutput.
`isUi`	`Boolean`	Проверяет, является ли значение объектом Ui.
`nonHtmlOutput` New	`Boolean`	Проверяет, что значение не является объектом HtmlOutput.
`nonTextOutput` New	`Boolean`	Проверяет, что значение не является объектом TextOutput.
`nonUi` New	`Boolean`	Проверяет, что значение не является объектом Ui.
`requireHtmlOutput` New	`HtmlOutput`	Возвращает значение как объект HtmlOutput или выбрасывает исключение.
`requireRepository` New	`T`	Возвращает репозиторий, убедившись, что он существует, иначе бросает исключение.
`requireService` New	`T`	Возвращает сервис, убедившись, что он существует, иначе бросает исключение.
`requireTextOutput` New	`TextOutput`	Возвращает значение как объект TextOutput или выбрасывает исключение.
`requireUi` New	`Ui`	Возвращает значение как объект Ui или выбрасывает исключение.

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.