Как устроены диапазоны (A1-нотация)

Диапазон — это адрес ячейки или прямоугольной области в A1-нотации, как в привычных электронных таблицах.

Формы записи

Запись	Что означает
A1	одна ячейка
A1:C10	прямоугольник от A1 до C10
Лист1!A1:C10	тот же диапазон на конкретном листе
'Мой лист'!B2	лист с пробелом или спецсимволами — имя в одинарных кавычках

Открытые диапазоны

Запись	Что означает
A:A	весь столбец A
A:C	столбцы A–C целиком
1:1	вся строка 1
A1:A	от A1 и до конца данных столбца

Сервер разворачивает открытый диапазон по фактическому размеру данных и возвращает в ответе поле range с конкретными границами.

URL-кодирование

Если диапазон в пути содержит имя листа (!) или двоеточие (:), закодируйте его: Лист1!A1:C10 → Лист1%21A1%3AC10.

Что приходит в ответе

Значения — сетка по строкам (majorDimension: ROWS). Каждая ячейка — { v, m, f? }: v — исходное значение, m — как видит пользователь, f — формула (если есть). Пустая ячейка — null. Большие диапазоны разбиваются на страницы (pagination с hasMore и nextOffset).

Числа, даты, формулы

• В v числа с точкой (1234.5), в m — по локали документа (1 234,50).
• Даты в v — серийные номера, в m — отформатированная строка.
• Формулы пишите английскими именами с ; между аргументами: =SUM(A1;B1).

Полный список методов чтения и записи — в Справочнике API.