Узнавайте расписание дня по календарям Яндекс 360

Агент работает с расписанием по протоколу CalDAV через caldav.yandex.ru. Сначала он забирает список календарей подключённого аккаунта — личные, общие и те, к которым вам выдали доступ, — затем читает события нужного периода вместе со временем, участниками, местом и напоминаниями. На этом строится расписание на сегодня и завтра, находятся наложения встреч, считаются свободные окна нужной длины и собирается утренняя сводка дня.

Календари Яндекса разнородны, и агент это учитывает: у каждого свой адрес коллекции, и события он запрашивает по одному календарю за раз, а не общим списком. CalDAV отдаёт встречу целым ics-объектом, поэтому повторяющуюся серию агент разворачивает в конкретные даты сам, а часовой пояс приводит к вашему. Событие, помеченное в календаре как не влияющее на занятость, он в занятое время не записывает.

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

Доступ подтверждается кодом на странице Яндекс ID, токен вводить руками не нужно: он обновляется сам и гаснет, как только вы отзываете разрешение в аккаунте. Календарь, закрытый для записи, агент отличает от несуществующего события и говорит, что именно мешает записи, вместо общей ошибки. Частоту обращений он выдерживает сам, длинные периоды забирает окнами по датам, а при нехватке доступа говорит прямо, а не показывает пустой день.