Si administras varias fichas en Google Maps, tarde o temprano llegas a la misma conclusión: hacerlo desde el panel oficial no escala. Ahí es donde entran la Google Business Profile API — antes conocida como Google My Business API o simplemente Google My Business platform — y herramientas como Mapgrid, que se apoyan en esa API para darte control real sobre decenas o cientos de ubicaciones.
Qué es la Google Business Profile API
La Google Business Profile API es la interfaz oficial de Google para leer y modificar de forma programática la información de una ficha de empresa: nombre, dirección, teléfono, horarios, categorías, atributos, fotos, publicaciones, reseñas y métricas de rendimiento. En la práctica, es lo que permite que un software externo haga lo mismo que harías tú a mano en business.google.com, pero multiplicado por cientos de ubicaciones y sin abrir el navegador.
En 2021 Google renombró el producto: lo que se llamaba Google My Business (GMB) pasó a llamarse Google Business Profile (GBP). La API también cambió de nombre — de Google My Business API a Google Business Profile API — y se dividió en varias APIs más pequeñas: Business Information, Account Management, My Business Verifications, My Business Notifications, My Business Business Information Performance y My Business Q&A. El endpoint monolítico v4 sigue vivo para posts, media y reseñas, pero está catalogado como legacy.
De Google My Business platform a Google Business Profile API
Muchos equipos siguen buscando en Google términos como "Google My Business API" o "Google My Business platform" porque así se llamó durante años. Hoy son sinónimos coloquiales de lo mismo, pero conviene tener claro cómo está partido el ecosistema:
- Business Information API: leer y actualizar la información básica de cada ficha (dirección, categoría, horarios, atributos).
- Account Management API: cuentas, grupos y gestores.
- Verifications API: iniciar y completar verificación por postal, teléfono, email o vídeo.
- Performance API: impresiones, búsquedas, llamadas, direcciones y clics al sitio web.
- v4 (legacy): posts, fotos y reseñas.
Todo esto funciona sobre OAuth 2.0 con el scope business.manage. Sin el scope, sin proyecto de Google Cloud aprobado y sin cuota concedida por Google, la API simplemente no responde a operaciones de escritura.
Las fricciones reales de trabajar con la API
En el papel la API parece completa. En un proyecto real, estos son los muros con los que se encuentran los equipos:
- Acceso restringido: Google exige rellenar un formulario y aprobar el proyecto antes de conceder cuotas útiles. Sin ese acceso extendido, la QPS por defecto se queda en un dígito.
- Endpoints repartidos: publicar una oferta, responder una reseña y actualizar horarios requiere hablar con tres APIs distintas, cada una con su propia versión, formato y comportamiento ante errores 5xx.
- Tokens que caducan: el access_token dura 60 minutos. Sin un refresh_token bien guardado y una lógica de renovación silenciosa, cualquier proceso en background se cae cada hora.
- Cambios sin previo aviso: en los últimos años Google ha deprecado la creación de posts tipo OFFER vía API, ha cambiado el flujo de verificación y ha ido migrando features del v4 legacy a v1. Un integrador tiene que perseguir el changelog.
- Escala: importar 500+ ubicaciones desde una cuenta requiere paginación, backoff, reintentos y — a partir de cierto volumen — flujos alternativos porque la API oficial no lista todo de una sola pasada.
Cómo Mapgrid convierte la API en una plataforma usable
Mapgrid está construido directamente sobre la Google Business Profile API oficial. No es un scraper ni un intermediario opaco: usa las mismas APIs, con OAuth business.manage, y añade encima la capa que la API por sí sola no ofrece.
- Onboarding en un clic: conectas tu cuenta de Google y Mapgrid importa todas las ubicaciones, incluidas cuentas grandes de más de 500 fichas, mediante un flujo Playground que evita los límites de listado.
- Bulk edit real: cambia horarios, categorías, atributos o descripciones en decenas de fichas a la vez desde una única tabla, con validación previa y push atómico a Google.
- Auditoría NAP automática: Mapgrid compara nombre, dirección y teléfono entre tu base local y Google, y te deja empujar la corrección hacia el lado correcto con un clic.
- Analytics históricos: la Performance API sólo devuelve datos recientes. Mapgrid los mueve a BigQuery y te da series completas desde julio de 2024 con filtros de 7/14 días, mes actual, mes anterior y ventanas personalizadas.
- Publicaciones programadas: crea posts UPDATE o EVENT y prográmalos. Mapgrid los publica vía API cuando corresponde y reintenta ante errores 500 transitorios de Google.
- Reseñas centralizadas: todas las reseñas de todas las fichas en una bandeja única, con análisis de sentimiento y respuesta directa vía API.
- Renovación silenciosa de tokens: el refresh_token se gestiona en servidor. Tu equipo no vuelve a ver una pantalla de "reconecta tu cuenta" en mitad de una campaña.
¿Cuándo tiene sentido integrarse tú mismo con la API?
Integrar la Google Business Profile API por tu cuenta tiene sentido si vas a construir un producto para vender a terceros, si tu ERP interno necesita sincronizar horarios de forma muy específica o si tu equipo dedica a esto ingeniería a tiempo completo. En cualquier otro escenario — una cadena, una franquicia, una agencia de marketing local, un e-commerce con tiendas físicas — el retorno de mantener esa integración en casa es negativo comparado con usar una plataforma que ya ha absorbido todos esos golpes.
Casos de uso reales
- Cadena de farmacias con 150 sucursales que unifica horarios festivos en 3 minutos en lugar de 3 días.
- Franquicia gastronómica que programa un post EVENT semanal por ubicación desde una plantilla.
- Agencia SEO local que audita el NAP de 40 clientes y factura la corrección como servicio recurrente.
- Retailer que exporta métricas de Performance API a su propio dashboard de BI vía el mirror de BigQuery.
Empieza con Mapgrid
La Google Business Profile API es potente, pero cruda. Mapgrid convierte esa potencia en una plataforma que un equipo de marketing o de operaciones puede usar sin escribir una línea de código. Puedes empezar hoy desde nuestros planes y conectar tu cuenta de Google en menos de dos minutos.