Cuando una API rechaza un token de sincronización incremental, repetir la misma petición puede dejar desactualizada la copia local. Primero distingue un fallo del punto de control de cambios de un problema de autenticación. Después reconstruye la copia según el contrato del proveedor antes de actualizar otros sistemas.
Respuesta breve
La API de Google Calendar puede devolver 410 cuando un syncToken deja de ser válido y exige una sincronización completa del almacén del cliente. La consulta delta de Microsoft Graph también puede requerir una nueva carga tras un reinicio 410 Gone o un token delta vencido. No equivale a renovar el token OAuth. Antes de enviar recordatorios, borrar registros locales o actualizar un CRM a partir de la copia, termina la lectura completa y concilia identificadores, eliminaciones y cambios.
Protocolo en cuatro etapas para liberar la copia
| Fase | Acción | Condición para seguir |
|---|---|---|
| Contener | Pausa los efectos basados en la copia; registra proveedor, colección, error y datos del punto de control sin exponer el token | Confirmar fallo del estado de cambios, no de acceso |
| Reconstruir | Conserva evidencia limitada del estado local; lee la colección completa en una copia de trabajo, con todas las páginas | Recibir el marcador final, como nextSyncToken o deltaLink |
| Conciliar | Compara IDs y estados; trata eliminaciones y restauraciones según el proveedor | Diferencias importantes explicadas o asignadas a una persona |
| Reanudar | Sustituye la copia local con el método seguro de la integración y recupera los efectos posteriores | Muestras y recuentos de control coherentes |
Este protocolo es síntesis editorial de Pulse, no una prueba de plataforma ni una orden de borrar el calendario original. La indicación de Google de limpiar el almacén del cliente se refiere a la copia de la aplicación. Conserva por separado las notas que solo existan localmente.
Comprueba el marcador final
Google devuelve nextSyncToken solo en la última página de la carga completa. Si la sincronización incremental tiene varias páginas, mantén los parámetros admitidos y continúa hasta recibir el nuevo token. Graph distingue @odata.nextLink de @odata.deltaLink, puede repetir cambios y marca eliminaciones con @removed en los recursos compatibles. Una primera página o una ausencia temporal no basta para declarar eliminado un registro.
Por ejemplo, una pequeña empresa en España sincroniza reservas de agenda antes de avisar a sus clientes. Si falla el token de cambios, detiene avisos basados en esa copia, la reconstruye y compara IDs antes de reanudar. El mismo criterio técnico sirve a equipos hispanoamericanos con esos endpoints, sin asumir normas nacionales. Es un ejemplo ficticio; Pulse no ejecutó la integración.
Cuándo detenerse
Detente si no puedes identificar la colección del token, si la lectura completa no termina, si cambiaron los parámetros, si una eliminación puede confundirse con lectura parcial o si perderías notas locales. Un 401 de acceso requiere otra revisión: comprueba la conexión. Durante la carga, verifica la paginación. Si ya faltan registros, investiga la brecha.