Модуль 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) на основі вихідного коду бібліотеки.