Первые шаги

Требования

Node.js версии 22.14.0 или новее
npm (или другой менеджер пакетов Node, например pnpm)

Установка

npm install apps-script-utils

Всё экспортируется из корня пакета, поэтому одного пути импорта достаточно для всей библиотеки:

import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script-utils";

Первые примеры

Работа с Таблицами

Эффективно добавить несколько строк данных:

import { appendRows } from "apps-script-utils";

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
  ["John Doe", "john@example.com", 28],
  ["Jane Smith", "jane@example.com", 32]
];

appendRows(sheet, data);

Утилиты Admin SDK

Проверить, есть ли у текущего пользователя права администратора:

import { isAdmin } from "apps-script-utils";

if (isAdmin()) {
  Logger.log("Access granted to admin panel.");
} else {
  Logger.log("Access denied.");
}

Разбор нотации A1

Превратить сложную нотацию A1 в структурированный объект:

import { parseA1Notation } from "apps-script-utils";

const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");

console.log(rangeInfo.sheetName); // "Sheet1"
console.log(rangeInfo.startRowIndex); // 0
console.log(rangeInfo.endColumnIndex); // 2

Проверка входных данных

Большинство функций библиотеки отвергают неверный ввод, а не приводят его к чему-нибудь. Семейство requireX превращает непроверенное значение в типизированное — или бросает исключение:

import { requireString, requireNonEmptyString } from "apps-script-utils";

function greet(name: unknown): string {
  return `Hello, ${requireNonEmptyString(name)}!`;
}

greet("Ada"); // "Hello, Ada!"
greet(""); // бросает EmptyStringException
greet(42); // бросает InvalidStringException

Соглашения о проверках разбирает всю схему имён isX/nonX/requireX/requireNonX, а Обработка исключений — исключения, которые эти функции бросают.

Куда дальше

Соглашения о проверках — соглашение об именах, которому подчиняется большая часть библиотеки.
Среда выполнения Apps Script — каким помощникам нужна среда Apps Script и что это значит для тестов.
Базовые утилиты — полный список функций, не зависящих от среды выполнения.
Модуль Google Apps Script — полный список функций, привязанных к сервисам.

23 September 2026

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