Все ноды/Integrations/Calendar

Занятость календаря

REPORT free-busy-query для заданных календарей.

Как попробовать

Как применять

Отвечает на один вопрос: какие интервалы заняты. Ни заголовков, ни участников, ни адресов событий — если нужны сами встречи, берите Запрос к календарю. Типичное применение — подобрать свободный слот, не заглядывая в содержимое чужого календаря: для этого часто хватает и тех прав, которых не хватает на чтение событий.

Как это работает

Нода спрашивает у сервера занятость по списку коллекций. Адреса перечисляются в поле «URL календарей» через запятую или с новой строки; пустое поле означает календарь по умолчанию из подключения. Диапазон обязателен и подчиняется тем же правилам, что и у запроса к календарю: ISO 8601, конец позже начала, не больше 366 дней, значение без часового пояса читается как UTC.

На выходе busy_periods — список пар { "start": …, "end": … }. Значения приходят такими, какими их прислал сервер: в базовом формате iCalendar (20260701T090000Z), а не в ISO с дефисами. Приводите их к нужному виду сами, если собираетесь показывать пользователю.

Частые ошибки

• Пустой список значит две разные вещи. «В диапазоне свободно» и «сервер не отдал сведений о занятости» выглядят одинаково. Проверьте ноду на календаре с заведомо занятым слотом, прежде чем строить на ней логику.
• Границей интервала может оказаться длительность. Формат допускает запись «начало и продолжительность», и тогда в end окажется что-то вроде PT1H. Разбирайте значение, а не считайте его временем безоговорочно.
• Свободные окна нода не считает. Она отдаёт занятое; вычитание интервалов из рабочего дня — ваша задача, например нодой JavaScript-код.
• Чужой календарь виден не всегда. Права на занятость выдаются на сервере отдельно; отказ приезжает с кодом ACCESS_DENIED.
• Один запрос — один аккаунт. Перечислять можно только коллекции того подключения, которое подано на порт: календари другого аккаунта — это другая нода с другой конфигурацией.

Входы

Выходы

Настройки