Планируйте встречи по календарям Google Workspace

Агент ходит в Google Calendar API v3 по вашему запросу: читает список календарей аккаунта, события с участниками, местом, описанием и напоминаниями, экземпляры повторяющихся встреч и занятость сразу по нескольким календарям. Из этого он собирает план на сегодня и завтра, находит накладки, подбирает свободное окно нужной длины для всех участников и по расписанию присылает сводку дня с остатком свободных часов.

Календарь Google устроен вокруг списка календарей конкретного аккаунта: агент видит ровно то, что в этом списке лежит, и обращается к каждому календарю отдельным запросом по его идентификатору. Уровень доступа тоже решает многое: на доступе к свободному времени видны только занятые интервалы без названий и участников, и накладку агент назовёт, а её причину — нет. Повторяющуюся встречу API отдаёт правилом, поэтому конкретные даты серии агент разворачивает сам.

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

Подключение — вход в аккаунт Google в отдельном окне, ключи копировать не нужно: доступ живёт токеном, который обновляется сам и гаснет, как только вы отзываете разрешение на странице доступа аккаунта. Частоту запросов агент выдерживает сам, чтобы не упереться в квоту Google, а длинные периоды забирает окнами по датам. Если календарь недоступен, доступ отозван или день действительно пуст, он скажет об этом прямо, а не покажет пустую таблицу.