Перейти к основному содержимому

Что нового

История изменений API и правила версионирования.

Политика версионирования​

Версия API указана в адресе: /api/v1. Мы придерживаемся простого правила — существующие интеграции не должны ломаться без предупреждения.

Считается совместимым изменением (может появиться в любой момент, без смены версии):

  • добавление новых эндпоинтов;
  • добавление новых необязательных параметров запроса;
  • добавление новых полей в ответ;
  • добавление новых значений в списки (где это не меняет смысл существующих).

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

Считается несовместимым изменением (выходит только в новой версии, например /v2):

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

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

Изменения​

2026-08-21 — ориентация значений и итог записи​

  • Параметр majorDimension (ROWS по умолчанию / COLUMNS) — на чтении (values/{range}, batchGet) задаёт форму сетки, на записи (PUT, append, batchUpdate) позволяет писать столбцами.
  • В ответах записи добавлены updatedRange (фактический записанный диапазон с именем листа), updatedRows, updatedColumns, updatedCells.

Оба изменения совместимые: параметр необязательный (по умолчанию — прежнее поведение), поля только добавлены.

2026-08-05 — роли документов и ограничение токенов таблицами​

  • В ответах GET /documents и GET /documents/{id} появилось поле permission — ваша роль в документе: owner, edit, comment, view.
  • Фильтр GET /documents?permission=edit — только таблицы, доступные для записи (владелец или редактор).
  • Токен можно ограничить конкретными таблицами (при создании ключа в настройках): для такого токена GET /documents возвращает только разрешённые таблицы, а обращение к таблице вне списка возвращает 403.

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

2026-07-09 — первый публичный выпуск​

  • Документы: список и получение по идентификатору.
  • Чтение значений: диапазон, batchGet, пагинация, открытые диапазоны.
  • Запись значений: PUT, batchUpdate, append, clear, формулы и спилл.
  • Идемпотентность записи через заголовок Idempotency-Key.
  • Листы: список, создание, переименование, удаление.
  • Вебхуки: подписки, доставка с HMAC-подписью, канал Telegram.
  • Аудит изменений через API.
  • Тарифные лимиты по частоте запросов, токенам и вебхукам.