Свободный слот — это снимок, а не обещание. Между ответом 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-12

Google 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, чтобы отмена или перенос обновляли правильное интервью.

  1. Получить free/busy всех обязательных календарей и отклонить ответ с ошибкой.
  2. Создать короткий hold атомарно внутри ATS.
  3. Повторить availability check непосредственно перед внешним insert.
  4. Создать event с organizer, attendees, UTC instant и IANA timezone.
  5. Сохранить provider event ID и подтвердить booking.
  6. При последующем конфликте остановить напоминания и предложить перенос, не создавая молча второе событие.

Контрольный прогон занимает несколько минут

Откройте два браузера кандидата и одновременно выберите один слот; затем добавьте ручную встречу рекрутера между hold и confirm. Ожидаемый итог — одно подтверждённое интервью, второй запрос получает новые варианты, а позднее внешнее изменение создаёт заметный conflict state. Для разбора понадобятся booking ID, calendar ID, provider event ID, timestamps, timezone и результат free/busy без названий приватных встреч.

Проверенные источники