Google My Business API fue reemplazada por Business Profile API, con cambios de endpoints, estructura de datos y métodos de autenticación. Cualquier integración construida sobre la versión anterior necesita migrar para seguir funcionando.
Qué cambió exactamente entre ambas versiones
Los endpoints cambiaron de estructura, algunos métodos se dividieron en APIs separadas (Account Management, Business Information, Notifications), y ciertos campos de datos fueron renombrados o reestructurados dentro de los objetos de ubicación.
El plan de migración recomendado
1. Inventario de llamadas actuales
Documenta cada endpoint de la API anterior que tu sistema utiliza actualmente, antes de tocar código.
2. Mapeo uno a uno hacia los nuevos endpoints
Cada llamada antigua debe mapearse a su equivalente en la nueva API, verificando cambios en los nombres de campos y en la estructura de las respuestas.
3. Migración gradual con ambiente de pruebas
Migra primero las operaciones de lectura (menor riesgo), valida los resultados contra el sistema anterior, y solo después migra las operaciones de escritura (edición de fichas, publicación de posts).
4. Monitoreo y ajustes post-migración
Una vez completada la migración, es crucial monitorear el rendimiento de la nueva API y realizar ajustes según sea necesario. Esto incluye verificar que todos los datos se estén sincronizando correctamente y que no haya errores en las respuestas.
Preguntas frecuentes
¿Se pierden datos históricos al migrar?
No, los datos viven en la cuenta de Google Business Profile, no en la API. La migración afecta cómo tu sistema se conecta y lee esos datos, no los datos en sí.
¿Hay un plazo límite para migrar?
Google ha ido descontinuando progresivamente los endpoints antiguos; cualquier integración que aún use My Business API debería considerar la migración una prioridad, no una tarea opcional.
¿Qué sucede si no migras a tiempo?
Si no realizas la migración a tiempo, podrías perder acceso a las funcionalidades que tu negocio necesita para operar eficientemente, lo que podría afectar tu visibilidad en línea y la interacción con tus clientes.
Conclusión
Migrar de Google My Business API a Business Profile API es técnicamente sencillo si se hace de forma planeada y gradual, pero riesgoso si se pospone hasta que Google fuerce el cambio.
Recuerda que una migración exitosa no solo implica trasladar datos, sino también asegurarte de que tu equipo esté capacitado para utilizar la nueva API y que todos los procesos estén optimizados para aprovechar las nuevas funcionalidades.
Checklist para la migración
- Realiza un inventario de las llamadas a la API actuales.- Mapea cada endpoint antiguo a su nuevo equivalente.- Configura un ambiente de pruebas para validar la migración.- Monitorea el rendimiento de la nueva API después de la migración.- Capacita a tu equipo sobre las nuevas funcionalidades y cambios.