API de Google Business Profile: qué hace y cómo obtener acceso
Por Toy Wen Da, Cofundador · Actualizado · 6 min de lectura
Traducido del original en inglés. Léelo en inglés
La API de Google Business Profile te permite gestionar los datos de la ficha, las reseñas, las publicaciones y las estadísticas mediante código, en lugar de usar el panel habitual. Es una buena opción para empresas y agencias que manejan muchas ubicaciones, y para desarrolladores que crean herramientas sobre Google Business Profile. El acceso no es automático: se solicita mediante un formulario de Google, y Google revisa cada solicitud antes de conceder una cuota.
Qué hace la API de Google Business Profile
El panel es la vía manual y la API es la vía programática, y ambas trabajan con los mismos datos de fondo: nombre del negocio, dirección, horarios, categorías, fotos, publicaciones, reseñas y métricas de rendimiento. Con la API, un software lee y escribe esos datos directamente, en lugar de que alguien los introduzca a mano. La diferencia importa en cuanto gestionas más de un puñado de ubicaciones, porque actualizar 40 fichas una por una es un trabajo muy distinto a enviar una sola actualización a las 40.
Para quién es
- Marcas con varias ubicaciones que mantienen coherentes los horarios, las categorías y las fotos en todos sus locales.
- Agencias que gestionan Google Business Profile de varios clientes desde un mismo sistema.
- Plataformas SaaS que crean herramientas de gestión de reseñas, SEO local o reputación sobre esos datos.
- Desarrolladores que crean paneles internos para franquicias o cadenas.
Un negocio con una sola ubicación rara vez necesita acceso directo a la API, ya que el panel ya cubre las publicaciones, la subida de fotos y las respuestas a reseñas. Una cuenta de desarrollador añadiría tiempo de configuración sin una ganancia proporcional.
Cómo obtener acceso a la API de Google Business Profile: los pasos
El acceso se gestiona a través de Google Cloud, no con el inicio de sesión habitual de Business Profile.
1. Crea un proyecto de Google Cloud
Configura un proyecto en la Google Cloud Console y activa la facturación. Más adelante, aquí también activarás la "Business Profile API" desde la Biblioteca de APIs (API Library).
2. Envía la solicitud de acceso a la API
Google restringe esta API con un formulario de solicitud, así que no basta con activarla. Tienes que describir tu caso de uso, tu negocio y cómo piensas usar los datos. Los plazos de aprobación varían: algunos desarrolladores comentan en foros de la comunidad que esperaron unas dos semanas, mientras que otros cuentan que los rechazaron varias veces, incluso cuando la solicitud era para gestionar su propia ficha de negocio.
3. Configura la pantalla de consentimiento de OAuth
Las credenciales creadas en modo "testing" suelen fallar sin avisar. Varios desarrolladores que investigaban problemas de acceso descubrieron que la solución era cambiar el estado de publicación de la pantalla de consentimiento de OAuth a "In Production", un paso fácil de pasar por alto y que rara vez se señala como causa de una llamada fallida.
4. Genera las credenciales y haz pruebas
Cuando te aprueben, crea credenciales de OAuth o de cuenta de servicio y haz pruebas con una ficha real. Si gestionas la ficha de un cliente, que te añadan como administrador de su Business Profile no te da acceso a la API. La solicitud de tu propio proyecto de Cloud tiene que aprobarse por separado.
Acceso propio a la API frente a una plataforma gestionada
Solicitar acceso directo a la API y usar una plataforma construida sobre ella resuelven el mismo problema de formas distintas.
| Enfoque | Esfuerzo de configuración | Coste habitual | Ideal para |
|---|---|---|---|
| Acceso directo a la API (tu propio proyecto de Cloud) | Alto: solicitud, espera de aprobación, configuración de OAuth, mantenimiento continuo | La API de Google es gratuita; el coste real es tu tiempo de ingeniería | Desarrolladores que crean una herramienta a medida o gestionan decenas de ubicaciones propias |
| Plataforma de terceros para gestionar GBP | Bajo: te registras y conectas tu ficha | Se han publicado planes basados en la API oficial desde unos $9.00 al mes para un par de ubicaciones | Agencias y negocios que quieren edición masiva y sincronización de reseñas sin mantener código |
| Solo el panel manual | Ninguno | Gratis | Negocios con una sola ubicación que gestionan publicaciones, horarios y reseñas de vez en cuando |
Las plataformas que anuncian acceso a la API de Google Business Profile suelen usar los endpoints oficiales y autorizados, no scraping del panel. Confírmalo antes de dar acceso a tu ficha, porque las herramientas basadas en scraping tienen más riesgo de que tu ficha acabe marcada.
Problemas habituales
Los retrasos en la aprobación no son la única fricción. Los desarrolladores que trabajan con la API cuentan que aparecen errores 404 "method not found" cuando las credenciales no coinciden con el scope correcto, y que el equipo de revisión de Google pide vídeos de demostración antes de aprobar ciertas aplicaciones OAuth. Además, es habitual que rechacen solicitudes cuando el correo de la cuenta no coincide con el dominio del propio negocio. Ninguno de estos problemas es un bloqueo permanente, pero cada uno suma tiempo real antes de que la API devuelva datos utilizables.
¿Necesitas acceso a la API o una mejor configuración del panel?
Solo necesitas acceso a la API si gestionas muchas ubicaciones o estás creando un producto con los datos de Google Business Profile; si no, lo que buscas es una mejor configuración del panel. Si el objetivo es una mayor visibilidad, como tener las categorías adecuadas, las preguntas y respuestas completas o publicaciones que no queden enterradas, eso es un problema del panel y del contenido, no de la API. Acertar con tus categorías de Google Business Profile o mejorar cómo se muestra tu sección de preguntas y respuestas de Google Business Profile suele mover más la aguja que cualquier cantidad de acceso programático. La API es la opción correcta cuando sincronizas decenas de ubicaciones o creas un producto en torno a los datos, y no te servirá si lo único que quieres es posicionarte mejor en las búsquedas locales.
La propia guía de Search Essentials de Google indica que la información de negocio precisa y mantenida de forma constante es la base del rendimiento de una ficha en la búsqueda local. La API puede ayudarte a escalar ese trabajo, pero no lo hará por ti. Para ver en qué punto está tu configuración actual, con API o sin ella, genera un informe SEO de muestra para tu sitio y tu ficha.
Preguntas frecuentes
¿Es gratuita la API de Google Business Profile?
La API en sí no tiene ninguna tarifa de licencia de Google, pero el acceso está sujeto a un proceso de aprobación, y la mayoría de los negocios acaban pagando una plataforma de terceros o horas de desarrollo para crear y mantener la integración.
¿Cuánto tarda Google en aprobar el acceso a la API de Google Business Profile?
Depende. En la comunidad se mencionan aprobaciones en unas dos semanas, pero algunas solicitudes se rechazan y hay que volver a enviarlas con más detalle sobre el caso de uso.
¿Puedo usar la API si solo soy administrador de la ficha de otra persona?
Que te añadan como administrador no te da acceso a la API por sí solo. Sigues necesitando tu propio proyecto de Google Cloud con una solicitud de API aprobada.
¿Por qué me aparece un error 404 al llamar a la API?
Normalmente indica que las credenciales o el scope no coinciden. A menudo se debe a que se usan credenciales de cuenta de servicio donde se esperaban credenciales de OAuth, o a que la API no se ha activado en el proyecto de Cloud.
¿Necesitan las pequeñas empresas la API de Google Business Profile?
Rara vez. Un negocio con una sola ubicación puede gestionar publicaciones, fotos, horarios y respuestas a reseñas desde el panel estándar. La API compensa cuando gestionas varias ubicaciones o creas software en torno a los datos.
Siguiente paso: descubre qué frena realmente tu ficha
Antes de dedicar semanas a una solicitud de la API de Google Business Profile, averigua si lo que necesitas arreglar es siquiera un problema de código. Habla con el equipo y consigue un informe SEO de muestra que te muestre qué está jugando ahora mismo en contra de tu visibilidad y si un acceso a nivel de API cambiaría algo.
Recursos / Referencias
Fuentes
Sobre el autor
SearchBlueprint investigó, escribió y puntuó este artículo con el mismo flujo de contenido que nuestros clientes usan en sus propios sitios. La puntuación que aparece junto al autor es la que nuestro motor de contenido dio a esta página antes de publicarla. Nada de esto se revisa a mano, y ese es el punto: es el resultado del producto, publicado donde cualquiera puede comprobarlo.