Cómo integrar GMBapi.com en BigQuery
La integración de los datos locales de GMBapi.com con BigQuery abre nuevas y potentes capacidades, permitiendo un análisis de datos avanzado, informes personalizados y una integración perfecta con tus herramientas existentes. Esta guía te lleva paso a paso a través de la configuración de la integración de BigQuery y la maximización de su potencial para tu negocio.
Lo que obtienes con nuestra integración de BigQuery
Con esta integración, puedes:
Acceder a tablas de BigQuery organizadas y estructuradas
(sin volcados de datos en bruto).
Las tablas se actualizan a diario con los datos más recientes de tus GBP.
Genera tus informes y análisis personalizados de Google
Business Profile.
Integra nuestros análisis prácticos directamente en tu propia plataforma, software o sitio web.
¡Utiliza el código proporcionado para replicar las visualizaciones que se ven en nuestro sitio web en tus informes o en tu sitio web!
Requisitos de integración de BigQuery y GMBapi.com
Antes de configurar tu integración con BigQuery, asegúrate de lo siguiente:
¡Tienes una cuenta activa de GMBapi.com con todas tus ubicaciones sincronizadas!
Tienes una cuenta de facturación activa asociada a tu proyecto de Google Cloud.
Has creado una cuenta de servicio con los siguientes roles: BigQuery Data Editor es necesario para crear/editar una tabla dentro de tu GCP. BigQuery Job User es necesario para programar y ejecutar consultas.
Comparte el correo electrónico de la cuenta de servicio y los nombres de las cuentas en app.gmbapi.com que deberían recibir acceso.
Una vez que se comparte el acceso a las tablas, puedes programar consultas utilizando la cuenta de servicio creada en tu propio proyecto de BigQuery.
Guía paso a paso para configurar la integración con BigQuery
*Si ya has creado una cuenta de Google Cloud Platform con la facturación configurada, puedes saltar al Paso 3
Paso 1: Crear un proyecto de Google Cloud
Navega a Google Cloud Platform.
Crea un nuevo proyecto o selecciona uno existente.
Paso 2: Configurar los detalles de facturación
Ve a la Consola de Google Cloud .
En el menú de la izquierda, selecciona “Facturación ” → luego haz clic en “Administrar cuentas de facturación ”.
Elige la organización apropiada (si corresponde) y haz clic en “Crear cuenta ”.
Ingresa un nombre para tu cuenta de facturación, selecciona tu país y conéctala a la organización correcta.
Agrega un método de pago válido y envíalo para habilitar la facturación.
Paso 2.1. Vincula tu cuenta de facturación al proyecto
En Google Cloud Console, selecciona el proyecto que quieres conectar.
Navega a la sección de “Facturación ”.
Si se te solicita, selecciona la cuenta de facturación para vincular a este proyecto.
Para cambiar las cuentas de facturación más tarde, haz clic en “Administrar cuentas de facturación ” y elige la opción adecuada.
⚠️ Nota: Sin la facturación habilitada, las consultas programadas y otras operaciones de BigQuery no se ejecutarán.
Paso 3: Crear y configurar una cuenta de servicio
En tu proyecto de Google Cloud, ve a IAM y administración > Cuentas de servicio .
Haz clic en Crear cuenta de servicio .
Nombra tu cuenta de servicio (p. ej.,
“Integración con BigQuery ”).Asigna los siguientes roles para asegurar que la cuenta de servicio tenga acceso para programar consultas y crear tablas dentro de GCP: Editor de datos de BigQuery Usuario de trabajos de BigQuery
Completa la creación de la cuenta de servicio y copia la dirección de correo electrónico generada.
Paso 4: Comparte el correo electrónico de la cuenta de servicio
Comparte el correo electrónico de la cuenta de servicio con nuestro equipo de soporte o a través de tu portal de gestión de integraciones.
Además, por favor, confirma la cuenta de GMBapi.com (grupo de ubicaciones de GBP) a la que quieres que acceda la cuenta de servicio.
Los datos se almacenan por cuenta de GBP, y se requiere acceso explícito para cada una.
Nota: Si necesitas acceso a cuentas de GBP adicionales en el futuro, simplemente repite desde el Paso 3 en adelante para cada nueva cuenta.
Paso 5: Configurar BigQuery
Ve a BigQuery en tu Google Cloud Console.
Crea un nuevo conjunto de datos o selecciona uno existente.
Importante : Establece la región del conjunto de datos en europe-west4 (Países Bajos).
Esto es necesario para transferir datos mediante una consulta programada; las regiones de origen y destino deben coincidir. Dado que GMBapi.com almacena datos en los Países Bajos, tu conjunto de datos también debe estar en esa región para habilitar la transferencia.
Nota: Si es necesario, puedes replicar o migrar tus datos a otra región más adelante. Más información 👉 Replicación de datos de BigQuery
Paso 6: Accede y utiliza tus datos
Una vez que se concede el acceso, tienes dos formas principales de trabajar con tus datos:
Consultas programadas (recomendado)
Usa consultas programadas en tu proyecto de BigQuery para copiar los datos organizados de GMBapi.com en tu propio conjunto de datos. Esto asegura el acceso y la propiedad de los datos a largo plazo.
Usa las credenciales de la cuenta de servicio al configurar las consultas programadas.
Acceso Directo a Través de la API de BigQuery
Alternativamente, puedes usar las credenciales de la cuenta de servicio para acceder a los datos directamente a través de la API de BigQuery en tu código.
✅ Recomendación: Para un mejor control, portabilidad y preparación para el futuro, recomendamos crear una copia de las tablas dentro de tu propio proyecto de GCP, ya sea a través de consultas programadas o programáticamente usando la API de BigQuery.
Nuestro equipo proporcionará plantillas SQL listas para usar y fragmentos de código visuales para ayudarte a empezar rápidamente.
Casos de Uso de Ejemplo para la Integración con BigQuery
Informes Personalizados
Genera informes personalizados específicos para las necesidades de tu negocio, profundizando en las métricas de rendimiento de SEO local.
Integración de Plataforma
Integra nuestras perspectivas sin problemas en tu CRM, panel de control del sitio web o cualquier plataforma de análisis que tu negocio utilice.
Análisis avanzado
Aprovecha las potentes capacidades analíticas de BigQuery para detectar tendencias, oportunidades e información procesable más rápido que nunca.
Obtener ayuda
Si te quedas atascado en cualquier punto del proceso, nuestro equipo está aquí para ayudarte. No dudes en contactarnos si no estás seguro sobre cómo configurar permisos, crear cuentas de servicio o programar consultas. Estamos comprometidos a hacer que tu proceso de integración sea fluido y exitoso.
Solicita acceso a un grupo de ubicaciones e inicia una prueba gratuita. Luego:
Contacta con nuestro equipo de soporte.
Configura tu proyecto de BigQuery.
Asegúrate de que tu cuenta de facturación esté activa.
Crea una cuenta de servicio con los roles correctos.
Comparte el correo electrónico de la cuenta de servicio y los nombres de cuenta de app.gmbapi.com relevantes.
Comienza a programar consultas para recuperar tablas de datos estructurados.
Para obtener ayuda detallada, accede a nuestra documentación completa o contacta directamente con nuestro equipo de soporte para agilizar tu experiencia de integración con BigQuery.
Aprovecha todo el potencial de tus datos de SEO local con nuestra potente integración con BigQuery, lo que facilita más que nunca tomar decisiones más inteligentes y basadas en datos.
Preguntas frecuentes sobre GMBapi.com y la integración con BigQuery
Preguntas frecuentes
Para configurar la integración, necesitas una cuenta activa de GMBapi.com con tus ubicaciones sincronizadas, un proyecto de Google Cloud con la facturación habilitada y una cuenta de servicio con los roles de BigQuery correctos. Una vez que tengas esto en su lugar, nuestro equipo puede otorgar acceso a tablas estructuradas de BigQuery que se actualizan diariamente con los datos de tu Perfil de Negocio de Google.
La cuenta de servicio debe tener los roles de Editor de datos de BigQuery y Usuario de trabajos de BigQuery. El rol de Editor de datos permite a la cuenta crear y editar tablas dentro de tu proyecto, mientras que el rol de Usuario de trabajos posibilita programar y ejecutar consultas. Sin estos roles, tu integración y transferencias de datos no funcionarán correctamente.
Tu conjunto de datos debe estar ubicado en europe-west4 porque GMBapi.com almacena sus datos en los Países Bajos. Google requiere que las regiones de origen y destino coincidan para que las transferencias de datos funcionen. Si las regiones no están alineadas, tus consultas programadas y tus pipelines de datos fallarán. Si es necesario, puedes replicar o migrar los datos a una región diferente más tarde, pero el conjunto de datos inicial debe estar en europe-west4.
Las tablas de BigQuery se actualizan diariamente con los datos más recientes de tus Perfiles de Negocio de Google. Esto asegura que tus análisis, paneles y reportes siempre reflejen las últimas métricas de rendimiento de SEO local sin necesidad de actualizaciones manuales.
Puedes acceder a tus datos de dos maneras principales. El método recomendado es usar consultas programadas, que copian las tablas estructuradas de GMBapi.com a tu propio proyecto de BigQuery para que mantengas el control y la propiedad a largo plazo. Alternativamente, puedes usar la API de BigQuery para consultar los datos directamente con las credenciales de tu cuenta de servicio. La mayoría de las empresas eligen las consultas programadas, ya que ofrecen más flexibilidad y portabilidad.
Sí, la integración está diseñada para funcionar sin problemas con tus herramientas existentes. Una vez que tus datos estén disponibles en BigQuery, puedes conectarlos directamente a tus paneles de control, sistemas CRM, sitios web o plataformas de análisis. Muchas empresas utilizan esta capacidad para crear paneles personalizados o integrar información en sus flujos de trabajo existentes.
Si encuentras algún problema, ya sea con la configuración de la cuenta de servicio, la habilitación de la facturación o la programación de consultas, puedes contactar al equipo de soporte de GMBapi.com. Nuestro equipo está disponible para guiarte a través del proceso y asegurarse de que tu integración funcione sin problemas de principio a fin.
