Возьмите одну разрешённую тестовую запись и проследите два независимых пути: выгрузку из сервиса в календарь и получение изменений из календаря обратно. Успешное создание события подтверждает только первый путь. Для второго нужны корректный календарь, сохранённое соответствие ID и рабочий курсор получения изменений.
Разделите ошибку доставки и ошибку применения
| Наблюдение | Следующая проверка |
|---|---|
| Во внешнем календаре нет события | Запрос создания и его окончательный исход |
| Событие есть, но ID не сохранён | Связь локальной записи с внешним объектом |
| Изменение не попало в ответ API | Календарь, параметры запроса и курсор |
| Изменение получено, экран прежний | Применение в локальную проекцию |
| Удалённое событие вернулось | Правила конфликтов и повторная выгрузка |
Сначала установите владельца данных: кто задаёт время визита, кто может отменять его и как внешнее изменение становится бизнес-операцией. Встреча в календаре может быть только отображением брони. Если это так, её ручное удаление не должно автоматически отменять оплаченную услугу без предусмотренного правила.
Для связи храните локальный ID, идентичность подключённого календаря и внешний event ID. Один event ID без контекста подключения усложняет разбор нескольких сотрудников и переподключений. В логах используйте обезличенные значения; OAuth-токены и персональные описания встреч туда не нужны.
Курсор сохраняется после последней применённой страницы
Условный цикл чтения:
получить изменения с сохранённым syncToken
применить страницу повторно безопасным способом
если есть nextPageToken -> читать дальше с тем же syncToken
после последней страницы сохранить nextSyncToken
Новый курсор нельзя фиксировать раньше сохранения изменений.Google Calendar описывает первичную полную и последующую инкрементальную синхронизацию. nextSyncToken появляется на последней странице. При постраничном чтении изменений используется прежний syncToken до завершения прохода; ответ включает удалённые объекты. Руководство проверено 28 октября 2026 года.
Если обработчик сохранил курсор, а затем упал до применения страницы, часть изменений может быть пропущена при следующем запуске. Если применил страницу и упал до сохранения курсора, она придёт повторно. Поэтому повторное применение должно быть безопасным: обновлять связанный объект и учитывать уже обработанную версию, а не создавать новую бронь на каждое получение.
Для одного подключения согласуйте параллельные проходы. Два процесса со старым курсором не должны перезаписывать более новую контрольную точку или применять запоздалое состояние поверх актуального. Конкретный механизм зависит от хранилища: один владелец задания, блокировка либо проверка версии записи курсора.
Ответ 410 требует пересборки проекции
При недействительном syncToken Google возвращает 410 и предписывает новую полную синхронизацию. Очистка касается локального хранилища синхронизируемых календарных данных. Если в той же базе живут бизнес-записи, платежи и история визитов, удалять их как часть сброса курсора нельзя. Разделите проекцию внешнего календаря и основной учёт.
- Сохранить соответствия ID и состояние проблемного подключения.
- Выполнить первичное чтение в отдельную восстанавливаемую проекцию.
- Дочитать все страницы и получить новый курсор.
- Сопоставить добавления, изменения и удаления по принятой политике.
- Проверить следующий инкрементальный проход и возврат обычного расписания.
Во время пересборки определите, откуда экран доступности получает данные. Пустая новая проекция не должна означать, что все интервалы внезапно свободны. До завершения используйте предусмотренное ограничение записи или последнюю подтверждённую картину с явно обозначенной неактуальностью. Выбор зависит от допустимого риска двойного бронирования.
Контрольный прогон включает создание, перенос и удаление тестового события, несколько страниц и повтор обработки после сбоя. Принудительно истекший курсор моделируйте на стенде. Итог сравнивайте по конкретным ID и времени, а не по общему зелёному индикатору «интеграция подключена».
Перед передачей проблемы интегратору подготовьте ID пары объектов, направление сбоя, последний успешный проход и код ответа без секретов. Отдельно укажите согласованную политику ручных изменений календаря. Эти сведения позволяют восстановить синхронизацию, сохранив историю бронирования и понятное поведение отмены.