Свободный слот — это снимок, а не обещание. Между ответом free/busy и нажатием «Подтвердить» рекрутер может создать встречу вручную, другой кандидат — выбрать тот же интервал, а синхронизация — принести событие из второго календаря. Сохраните точную временную шкалу конфликта и временно не рассылайте новые приглашения на спорный слот.
Первый практический шаг: перевести начало и конец обеих встреч в UTC, но сохранить исходную IANA timezone. Затем сравнить календари, которые реально участвовали в availability query, и organizer calendar, куда ушёл Events.insert. Часто проверяется личный календарь, а событие создаётся в общем или наоборот.
Окно гонки видно по четырём меткам времени
12:00:00.120Z availability_checked -> free
12:00:07.540Z slot_hold_created -> expires 12:05Z
12:00:09.010Z external_event_seen -> busy
12:00:12.330Z candidate_confirmed
decision: reject confirmation, release hold, offer new slots
correlation: booking_id=BK-418, calendar_id=cal-recruiter-12Google Calendar Freebusy возвращает занятые интервалы для перечисленных calendars в заданном RFC3339-диапазоне; конец busy-интервала трактуется как исключающий. API ограничивает число календарей в одном запросе, поэтому ошибки expansion и missing calendar нельзя превращать в «свободно». Неуспешная проверка должна закрывать слот, а не открывать его.
Конфликт бывает не только из-за одновременного клика
| Признак | Причина | Следующее действие |
|---|---|---|
| Всегда сдвиг ровно на час | Timezone или DST | Сравнить offset и IANA zone на входе и событии |
| Два кандидата выбрали один слот | Нет локального hold | Проверить unique reservation и TTL |
| Busy появился после подтверждения | Ручное внешнее событие | Проверить push/sync lag и reconcile |
| Private meeting не видна деталями | Недостаточно прав, но busy доступен | Использовать freeBusyReader, не требовать summary |
| Конфликт только у recurring series | Неверно развёрнуты instances | Проверить recurrence timezone |
| Событие создано дважды | Повтор booking request | Стабильный event ID или idempotency record |
Google Calendar принимает timed events через start.dateTime и end.dateTime; offset обязателен, если timezone не указана. Для recurring events timezone определяет разворачивание серии. Хранить только локальную строку «10:00» недостаточно: после изменения правил летнего времени восстановить намерение уже нельзя.
Протокол бронирования зависит от владельца истины
- Если ATS владеет слотами, она атомарно создаёт hold в своей базе, повторно проверяет busy и только затем создаёт календарное событие.
- Если календарь разрешает свободные ручные встречи, free/busy перед confirm уменьшает риск, но не даёт абсолютной блокировки внешнего мира.
- При создании события сохраняются provider event ID, organizer calendar ID, booking ID и исходная timezone.
- Кандидату показывается подтверждение только после получения event ID; промежуточное состояние называется pending.
- Push notification или incremental sync запускает reconciliation и помечает поздний конфликт для переноса.
Локальный hold должен иметь TTL и уникально защищать recruiter + интервал в вашей модели. Для переменной длительности одной UNIQUE по start_at мало: интервалы могут пересекаться с разными началами. Подойдёт сериализация бронирований по рекрутеру и дню либо ограничение пересечения диапазонов в базе. Конкретная реализация зависит от СУБД и нагрузки.
Изменения календаря нужно догонять, а не ждать следующего кандидата
Google Calendar поддерживает push notifications для Events, однако notification сообщает, что ресурс изменился, и после неё нужно получить актуальные данные. Для локальной копии используйте initial sync, сохраняйте sync token и делайте incremental sync; при недействительном token выполняется полный sync. Свяжите внешний event ID с booking, чтобы отмена или перенос обновляли правильное интервью.
- Получить free/busy всех обязательных календарей и отклонить ответ с ошибкой.
- Создать короткий hold атомарно внутри ATS.
- Повторить availability check непосредственно перед внешним insert.
- Создать event с organizer, attendees, UTC instant и IANA timezone.
- Сохранить provider event ID и подтвердить booking.
- При последующем конфликте остановить напоминания и предложить перенос, не создавая молча второе событие.
Контрольный прогон занимает несколько минут
Откройте два браузера кандидата и одновременно выберите один слот; затем добавьте ручную встречу рекрутера между hold и confirm. Ожидаемый итог — одно подтверждённое интервью, второй запрос получает новые варианты, а позднее внешнее изменение создаёт заметный conflict state. Для разбора понадобятся booking ID, calendar ID, provider event ID, timestamps, timezone и результат free/busy без названий приватных встреч.