Ver categorías

Cómo conectar Google Search Console a Google Sheets: consulta de datos SEO con SQL

Conectar · Search Console con Google Sheets

Obtenga datos de Consola de búsqueda en Hojas de cálculo de Google

Importa filas en tiempo real desde tu cuenta de Search Console a Google Sheets y actualízalas cuando quieras. Sin subir archivos CSV, sin usar Apps Script, sin copiar y pegar. Solo te llevará unos diez minutos la primera vez, y el plan gratuito lo incluye.

Aproximadamente 10 minutos No se necesita programar Las credenciales permanecen contigo Cualquier navegador, cualquier dispositivo
¿Tienes algún problema? Pregúntanos. Abrir Ayuda En Consultas de flujos (menú superior derecho → Soporte) y envíanos un mensaje. Personas reales lo leen, y «No sé qué me pide esta pantalla» es una pregunta perfectamente válida.

Lo que obtendrás al final

Logotipo de Google Search ConsoleUna hoja de cálculo de Google que muestra los resultados en tiempo real de una consulta SQL en tu cuenta de Search Console, con un botón que muestra las filas más recientes cada vez que cambian los datos. Algo así:

Google Search Console almacena tus datos tras su API. Para importarlos a Google Sheets, normalmente tienes que exportar un archivo CSV desde el panel de Search Console cada vez que necesites datos actualizados. Query Streams evita este paso: un pequeño programa auxiliar llamado Agente ejecuta la consulta donde se encuentran tus datos, y un complemento de Google Sheets solicita las filas que necesitas. Solo se transmiten los resultados, a través de un enlace cifrado, y Google Sheets puede estar en cualquier lugar: en cualquier navegador y en cualquier dispositivo.

DÓNDE CORRE EL AGENTEcualquier ordenador o servidor siempre encendido con conexión a internet.Su consola de búsquedacuentaLas llaves se quedan aquíAgente de flujos de consultasposee las credencialesFlujos de consultaenlace cifradopor internet · solo resultadosDONDEQUIERA QUE ESTÉSCualquier navegador: portátil, tableta, teléfono, ChromebookHojas de cálculo de GoogleLas filas llegan en una hoja
El agente reside con tus datos. Tu hoja de cálculo se encuentra en la nube de Google. Ábrela desde cualquier lugar y las filas aparecerán automáticamente.

Lo que necesitarás

Una cuenta de Query Streams

El plan gratuito es suficiente para esta guía. Regístrate en mi.querystreams.com.

El agente en cualquier ordenador que esté siempre encendido

Un pequeño programa que se ejecuta en segundo plano y llama a Search Console cuando Google Sheets lo solicita. Solo necesita acceso a internet.

Su inicio de sesión de Search Console

Deberás iniciar sesión en Search Console una sola vez y otorgar acceso de lectura. No es necesario introducir contraseñas en los flujos de consulta.

¿Qué ordenador recibe el Agente? Cualquier máquina que esté siempre encendida y que ya pueda acceder a tu cuenta de Search Console. Google Sheets puede estar en cualquier lugar; se ejecuta en tu navegador.

Conéctalo en cinco pasos

  1. Crea tu cuenta

    Ir a mi.querystreams.com y regístrese. Elija el Gratis Es un plan real, no una versión de prueba, y abarca la conexión de tu cuenta de Search Console y la ejecución de consultas desde Google Sheets.

  2. Instale el agente en cualquier ordenador que esté siempre encendido.

    Iniciar sesión, abrir DescargarInstale el Agente en cualquier ordenador o servidor que esté siempre encendido y tenga acceso a internet. El proceso tarda un minuto y, a partir de ese momento, se inicia automáticamente.

    ¿Por qué un programa pequeño en lugar de un controlador? El Agente es una única instalación para Windows, Mac o Linux (aproximadamente 85 MB en Windows, algo más de 100 MB en Mac y Linux) que se ejecuta discretamente en segundo plano. Establece una única conexión saliente cifrada a Query Streams, del mismo modo que lo hace un navegador, por lo que no es necesario abrir ningún puerto del firewall ni configurar una VPN. Tus claves permanecen en tu equipo y los datos se transmiten a dondequiera que estés, incluso a través de internet si es necesario. Lo único que necesitas es el complemento.

    La página de descarga muestra Su clave de accesoPégalo en el Agente cuando te lo pida y espera a que aparezca la insignia. Conectado a flujos de consulta. Eso es lo único que debes hacer en el propio Agente.

    Si lo deseas, aquí tienes las guías completas: Ventanas, Impermeable, Linux.

  3. Apúntalo a tu cuenta de Search Console

    De vuelta en tu navegador, abre Agentes de datos (bajo Datos (en el menú superior). Su agente aparece allí. Haga clic. Agregar conector y elegir Consola de búsqueda de Google¿Necesitas primero tus credenciales de Search Console? Abre el tutorial y luego completa:

    Crea tus credenciales de Search Console (unos 15 minutos)

    A continuación, abre Google Search Console en otra pestaña. Query Streams guarda la información que crees aquí para que tu agente pueda usarla, y solo la lee desde Google Search Console.

    ¿Quién puede hacer esto?
    Search Console: Propietario (verificado o delegado) de la propiedad, para agregar la cuenta de servicio como usuario. Google Cloud: Propietario del proyecto (obtienes el rol de Propietario en cualquier proyecto que crees), o los roles de Crear cuentas de servicio, Administrador de clave de cuenta de servicio y Administrador de uso del servicio en dicho proyecto.
    Recomendado
    Clave JSON de la cuenta de servicio de Google Cloud (un archivo .json de tipo service_account), con la cuenta de servicio agregada como usuario restringido en la propiedad de Search Console.

    Antes de empezar

    • Tu sitio ya está añadido y verificado en Google Search Console. Una propiedad nueva puede tardar hasta una semana en tener datos disponibles en Google.
    • Acceso de propietario a esa propiedad de Search Console. Solo los propietarios pueden agregar usuarios. Si usted es un usuario con permisos completos o restringidos, puede realizar la parte de Google Cloud (pasos del 1 al 12) y solicitar a un propietario que realice los pasos del 13 al 17.
    • Una cuenta de Google que permita crear un proyecto de Google Cloud o administrar uno ya existente. Si la organización de Google Cloud de su empresa se creó el 3 de mayo de 2024 o después, Google bloquea las descargas de claves de forma predeterminada, y es posible que su administrador de Google Cloud deba autorizarlas (consulte Problemas comunes).
    • No se requiere cuenta de facturación. Google no cobra por la API de Search Console.
    • ¿Ya configuraste el conector de Google Analytics 4 de Query Streams con una cuenta de servicio? Puedes reutilizarlo: habilita la API de Search Console en el mismo proyecto (paso 4) y luego ve al paso 13 con el correo electrónico de esa cuenta de servicio. El mismo archivo de clave JSON se usa en ambos conectores.
    • El asistente de Flujos de consulta se abre en otra pestaña (Agentes de datos → Agregar conector → Google Search Console) con su agente en línea.

    Pasos

    1. Abrir y administrar recursos en Google Cloud

      Inicia sesión con tu cuenta de Google, abre la página Gestionar recursos de la consola de Google Cloud y haz clic en Crear proyecto.

      ¿Ya tienes un proyecto de Google Cloud que quieras usar, como el que creaste para el conector de Google Analytics 4? Ve al paso 3 y selecciónalo allí. La primera vez que abras Google Cloud, es posible que Google te pida tu país y que aceptes sus Términos de Servicio antes de mostrar la página.

    2. Nombre y cree el proyecto

      En la ventana Nuevo proyecto, escriba un nombre para el proyecto, como «Consulta de la consola de búsqueda de Streams». Deje el campo de organización o carpeta principal como lo completa Google. Si no se ofrece ninguna organización, no hay problema. Haga clic en Crear.

      Los nombres de los proyectos deben tener entre 4 y 30 caracteres: letras, números, espacios, guiones, comillas simples y signos de exclamación. No es necesario seleccionar una cuenta de facturación.

    3. Seleccione el proyecto

      Haz clic en el selector de proyectos que se encuentra en la parte superior de la página, junto al logotipo de Google Cloud, y luego en el nombre de tu proyecto. Todos los pasos de Google Cloud que se describen a continuación se realizan en este proyecto.

      El error más común es habilitar la API en un proyecto y crear la clave en otro. Verifica el nombre del proyecto en la parte superior de la página antes de cada paso de Google Cloud.

    4. Habilita la API de Google Search Console

      Abre la página de la API de Google Search Console en la Biblioteca de API. Comprueba que el nombre de tu proyecto aparezca en la parte superior y, a continuación, haz clic en Habilitar.

      También puedes acceder desde API y servicios → Biblioteca: busca la API de Google Search Console. No selecciones la API de indexación ni la API de verificación del sitio, ya que Query Streams no las utiliza. Si Google indica que la API ya está habilitada, continúa con el paso 5. Esta API abarca todo lo que Query Streams lee: tu lista de propiedades, mapas del sitio, datos de rendimiento e inspección de URL.

    5. Abra la página Crear cuenta de servicio

      Abra la página Crear cuenta de servicio. Desde Google Cloud también puede abrir el menú de navegación (tres líneas, arriba a la izquierda), seleccionar IAM y administración → Cuentas de servicio y hacer clic en + Crear cuenta de servicio.

      ¿Vas a reutilizar la cuenta de servicio del conector de Google Analytics 4? No crees una segunda. Realiza el paso 4 en su proyecto y luego ve al paso 13 con su correo electrónico.

    6. Nombre la cuenta de servicio

      En el campo Nombre de la cuenta de servicio, escriba query-streams-gsc. Google completará automáticamente el ID de la cuenta de servicio. La descripción es opcional. Haga clic en Crear y continuar.

      El ID no se puede cambiar posteriormente. Se convierte en la primera parte de la dirección de correo electrónico de la cuenta de servicio.

    7. Omitir los roles del proyecto

      La siguiente sección ofrece los roles del proyecto. Deje el campo de rol vacío y haga clic en Continuar.

      No le otorgues a la cuenta de servicio los permisos de Propietario, Editor o Lector aquí. Su acceso a los datos de Search Console se concede dentro de Search Console en el paso 16. Un rol de Google Cloud no tiene ninguna función en Search Console y solo amplía las funcionalidades de la clave en Google Cloud.

    8. Finalizar la creación de la cuenta de servicio

      Deje la última sección (Rol de usuario de cuenta de servicio y Rol de administrador de cuenta de servicio) vacía y haga clic en Listo. Volverá a la lista de cuentas de servicio.

    9. Copia el correo electrónico de la cuenta de servicio

      En la lista, busque la nueva cuenta. Su correo electrónico tiene el formato [email protected]. Cópielo y guárdelo para el paso 16.

      Copia la dirección completa, incluyendo .iam.gserviceaccount.com. Esta misma dirección se encuentra en el archivo de clave del paso 12, en la línea client_email. Google indica que una nueva cuenta de servicio puede tardar un minuto o más en estar lista para usar.

    10. Abra la pestaña Claves

      Haz clic en la dirección de correo electrónico de la cuenta de servicio y, a continuación, haz clic en la pestaña Claves.

    11. Iniciar una nueva clave

      Haz clic en Agregar clave y luego elige Crear nueva clave.

      Si aparece un cuadro titulado "La creación de claves de cuenta de servicio está deshabilitada", su organización bloquea la descarga de claves. Consulte Problemas comunes.

    12. Descarga la clave JSON

      Selecciona JSON como tipo de clave y haz clic en Crear. Tu navegador descargará un archivo .json, normalmente en tu carpeta de Descargas.

      Esta descarga se realiza una sola vez: no se puede descargar el mismo archivo de nuevo. Si lo pierde, cree una nueva clave y elimine la anterior. No seleccione P12. Mantenga el archivo privado. No lo envíe por correo electrónico ni lo coloque en una carpeta compartida, ya que cualquier persona que lo tenga podrá leer estos datos de Search Console. Query Streams lo almacena para su agente y solo lo lee con él.

    13. Abre Search Console y selecciona la propiedad.

      Abre Google Search Console e inicia sesión como propietario del sitio. En el menú desplegable de propiedades situado en la parte superior izquierda, selecciona la propiedad que deseas que Query Streams lea.

      Si el sitio aparece dos veces, una como nombre simple (example.com) y otra como dirección (https://www.example.com/), el nombre simple es la propiedad de dominio. Cubre todos los subdominios y tanto http como https, por lo que suele ser la opción a elegir.

    14. Usuarios y permisos abiertos

      En el menú de la izquierda, desplácese hacia abajo y haga clic en Configuración. A continuación, haga clic en Usuarios y permisos.

      Solo los propietarios pueden ver la información sobre usuarios y permisos. Si no aparece, usted es un usuario con permisos completos o restringidos: envíe el correo electrónico del paso 9 al propietario del inmueble y pídale que siga los pasos del 13 al 17.

    15. Haz clic en Agregar usuario

      Haz clic en Agregar usuario en la parte superior derecha de la página Usuarios y permisos. Se abrirá el cuadro Agregar usuario.

    16. Ingrese el correo electrónico de la cuenta de servicio y seleccione Restringido.

      Pegue el correo electrónico de la cuenta de servicio del paso 9 en Dirección de correo electrónico. Abra la lista de permisos y seleccione Restringido.

      Con el acceso restringido es suficiente: Google permite a los usuarios con acceso restringido ver todos los informes, incluido el de rendimiento, y usar la inspección de URL. El acceso completo también funciona. En cualquier caso, el agente solo solicita a Google acceso de solo lectura, por lo que no puede enviar mapas del sitio, eliminar URL ni cambiar la configuración.

    17. Agregue la cuenta de servicio

      Haz clic en Agregar. La cuenta de servicio ahora aparece en la lista de usuarios de la propiedad con permisos restringidos.

      Si Search Console no acepta la dirección (por ejemplo, indica que el correo electrónico no coincide con una cuenta de Google o que no se encontró), consulta Problemas comunes. Google tiene un problema conocido con las cuentas de servicio recién creadas desde abril de 2026.

    18. Observe cómo está escrita la propiedad.

      Fíjese en el nombre de la propiedad en el menú desplegable de propiedades. Un nombre simple como example.com es una propiedad de dominio: deberá introducirlo como sc-domain:example.com. Una dirección completa como https://www.example.com/ es una propiedad de prefijo de URL: deberá introducirla exactamente como se muestra, con http o https, www o sin www, y la barra diagonal al final.

      Aún más sencillo: el botón Detectar del asistente de Consulta de flujos muestra los valores exactos. Si escribe https://example.com/ cuando la propiedad es https://www.example.com/, o si omite la última barra, se apunta a una propiedad que la cuenta de servicio no puede leer.

    Permisos para otorgar

    RecursoAcceda aUtilizado para
    Permisos de usuario de Search Console (Configuración → Usuarios y permisos)Restringido (Completo también funciona)Todas las tablas de gsc: search_analytics (datos de rendimiento: clics, impresiones, CTR y posición por fecha, consulta, página, país y dispositivo), sitios y mapas del sitio, todas activadas por defecto, además de url_inspection (desactivada por defecto, se ejecuta bajo demanda). Google permite a los usuarios restringidos ver todos los informes y usar la inspección de URL.
    API de Google Cloud: API de Google Search ConsoleActivadoPrueba la conexión, el botón Detectar y todas las tablas gsc. Sin ello, Google devuelve un error 403 a cada llamada.
    Ámbito de OAuth https://www.googleapis.com/auth/webmasters.readonlySolicitado por el agente (no es necesario que usted configure nada).Cada tabla gsc, prueba de conexión y detección. Google describe este ámbito como acceso de solo lectura, por lo que el Agente no puede enviar mapas del sitio, eliminar URL ni cambiar ninguna configuración.
    Rol de proyecto de Google Cloud para la cuenta de servicioNingunoNinguna tabla necesita uno. El acceso a Search Console proviene únicamente del permiso de usuario mencionado anteriormente.
    Propietario de Search Console (la persona que realiza la configuración, no la cuenta de servicio)Propietario (verificado o delegado)No hay tabla. Solo los propietarios pueden agregar usuarios a una propiedad.

    Pegar en flujos de consulta

    Clave JSON de la cuenta de servicio
    El archivo .json completo del paso 12. Haga clic en «Cargar desde este equipo» debajo del cuadro y seleccione el archivo (o «Desde un archivo en el agente…» si el archivo se encuentra en el equipo del agente). También puede abrir el archivo en el Bloc de notas (TextEdit en Mac), seleccionar todo, copiar y pegar desde la primera { hasta la última }. Cuando edite el conector más adelante, deje este cuadro en blanco para conservar la clave almacenada o introduzca un archivo nuevo para reemplazarla.
    URL de la propiedad del sitio
    Haz clic en Detectar junto al cuadro una vez que hayas introducido la clave (tu agente debe estar en línea). El cuadro mostrará una lista de todas las propiedades que la cuenta de servicio puede ver, como sc-domain:example.com — siteRestrictedUser. Selecciona la tuya. O introdúcela como se calculó en el paso 18: sc-domain:example.com para una propiedad de dominio, o la dirección completa con la barra diagonal final, como https://www.example.com/, para una propiedad de prefijo de URL.

    Problemas comunes

    La prueba de conexión falla con el error "Tipo de clave no válido. Se esperaba 'service_account'".

    Por qué: El archivo no es una clave de cuenta de servicio. Normalmente es un archivo de cliente OAuth (con un nombre como client_secret_….json) o una clave API de API y servicios → Credenciales.

    Arreglar: Cree una clave JSON en la cuenta de servicio (pasos 10 a 12) y utilice ese archivo. Una clave de cuenta de servicio contiene la línea “type”: “service_account”.

    La prueba de conexión falla con un formato JSON no válido o con el campo 'private_key' faltante o vacío en la clave de la cuenta de servicio.

    Por qué: Solo se copió una parte del archivo, o bien el texto se modificó durante la copia.

    Arreglar: Haz clic en «Subir desde este ordenador» y selecciona el archivo .json en lugar de copiarlo. O bien, abre el archivo de nuevo en el Bloc de notas (TextEdit en Mac), pulsa Ctrl+A (Cmd+A en Mac), cópialo y pégalo sin nada antes ni después.

    La prueba de conexión falla con la cuenta de servicio '…' no tiene propiedades de Search Console, o Detect dice que no se detectó nada.

    Por qué: Search Console aún no ha agregado la cuenta de servicio a ninguna propiedad. Los pasos del 13 al 17 se omitieron, se realizaron en un sitio diferente o Search Console rechazó el correo electrónico.

    Arreglar: Agregue la dirección de correo electrónico exacta del paso 9 como usuario en la propiedad (pasos 13 a 17). Compruebe que ahora aparece en Usuarios y permisos y, a continuación, haga clic en Probar de nuevo.

    La prueba de conexión falla con el mensaje "La cuenta de servicio '…' no tiene acceso. Agréguela a la propiedad de Search Console", aunque la cuenta de servicio aparece en Usuarios y permisos. Detect puede mostrar el mensaje de Google: "La API de Google Search Console no se ha utilizado en el proyecto … anteriormente o está deshabilitada".

    Por qué: La API de Google Search Console no está habilitada en el proyecto de Google Cloud al que pertenece la clave (la línea project_id en el archivo de clave). Google rechaza esas llamadas con un error 403, que la prueba reporta como acceso no disponible.

    Arreglar: Seleccione ese proyecto en Google Cloud, habilite la API de Google Search Console (paso 4), espere unos minutos y vuelva a hacer clic en Probar.

    La prueba de conexión indica Conectado, pero gsc.search_analytics permanece vacío y el registro del agente muestra el error de la API de Search Analytics: Prohibido.

    Por qué: La URL de la propiedad del sitio no coincide exactamente con la propiedad a la que se agregó la cuenta de servicio: sc-domain: en lugar de https://, www en lugar de sin www, http en lugar de https, o falta una barra diagonal final. La prueba solo verifica que la cuenta de servicio pueda ver al menos una propiedad. La sincronización lee la que usted ingresó.

    Arreglar: En Data Agents, abra el conector y haga clic en Editar. Haga clic en Detectar junto a URL de propiedad del sitio, seleccione la propiedad de la lista, haga clic en Probar conexión y, a continuación, Guardar cambios.

    Search Console no permite agregar la cuenta de servicio. Indica que el correo electrónico no coincide con una cuenta de Google o que no se pudo agregar el usuario: no se encontró el correo electrónico.

    Por qué: Un problema conocido de Google: desde finales de abril de 2026, Search Console y Google Analytics a veces no reconocen las cuentas de servicio recién creadas durante un tiempo. Los desarrolladores informaron de este problema hasta septiembre de 2026. Un error tipográfico o un espacio en la dirección produce el mismo mensaje.

    Arreglar: Vuelve a pegar la dirección sin espacios. Si sigue siendo rechazada, espera unas horas e inténtalo de nuevo. Normalmente, funciona con una cuenta de servicio creada previamente: si tienes una (por ejemplo, del conector de Google Analytics 4), añade su correo electrónico y utiliza su archivo de clave.

    Google Cloud muestra que la creación de claves de cuenta de servicio está deshabilitada cuando hace clic en Crear nueva clave.

    Por qué: Tu organización aplica la política iam.disableServiceAccountKeyCreation. Google la activa de forma predeterminada para las organizaciones creadas a partir del 3 de mayo de 2024.

    Arreglar: Solicita a tu administrador de Google Cloud (alguien con el rol de Administrador de políticas de la organización) que exima a este proyecto de la política. Google documenta una exención basada en etiquetas para un solo proyecto. Luego, repite los pasos 11 y 12.

    Un conector que antes funcionaba deja de sincronizarse y la prueba de conexión falla con el error de conexión: … invalid_grant … Firma JWT no válida.

    Por qué: La clave fue eliminada, deshabilitada o caducó en Google Cloud.

    Arreglar: Crea una nueva clave (pasos 10 a 12). En Data Agents, abre el conector, haz clic en Editar, coloca el nuevo archivo en Clave JSON de la cuenta de servicio, haz clic en Probar conexión y, a continuación, guarda los cambios. Elimina la clave anterior en Google Cloud.

    La prueba de conexión falla con un error que menciona invalid_grant e Invalid JWT: el token debe ser un token de corta duración.

    Por qué: El reloj del ordenador del agente está desfasado varios minutos. Google rechaza los inicios de sesión desde un ordenador con la hora incorrecta.

    Arreglar: Active la hora automática (de Internet) en el ordenador del agente y, a continuación, haga clic en Probar de nuevo.

    Los clics y las impresiones en gsc.search_analytics suman menos que el gráfico de rendimiento de Search Console.

    Por qué: Google excluye las consultas poco frecuentes (anonimizadas) de cada respuesta fila por fila, aunque los totales del gráfico sí las incluyen. Además, Google devuelve como máximo 50 000 filas al día por tipo de búsqueda para cada propiedad. La propiedad de prefijo de URL también abarca una menor parte del sitio que la propiedad de dominio.

    Arreglar: No hay ningún problema. Compara la suma de las filas con la tabla de Search Console en lugar del total del gráfico, y selecciona la propiedad Dominio si quieres ver todo el sitio.

    Faltan los datos de los dos o tres días más recientes en gsc.search_analytics.

    Por qué: Los datos de Google suelen estar listos entre dos y tres días después de su publicación. El agente solo lee los datos finales de Google, hasta tres días antes de la fecha actual.

    Arreglar: No hay nada que cambiar. Esos días llegan en sincronizaciones posteriores. Cada sincronización también vuelve a leer los últimos cinco días, por lo que se detectan los cambios tardíos.

    Desea que Query Streams deje de leer esta propiedad.

    Por qué: Eliminar el conector no elimina el acceso de Google. La cuenta de servicio sigue siendo un usuario y la clave sigue siendo válida.

    Arreglar: En Search Console → Configuración → Usuarios y permisos, abre el menú junto a la cuenta de servicio y haz clic en Eliminar acceso. En Google Cloud, abre la pestaña Claves de la cuenta de servicio y elimina la clave. A continuación, elimina el conector en Data Agents.

    Límites a conocer

    • Historial: Search Console guarda los últimos 16 meses. La primera sincronización del Agente lee los 16 meses completos; los días anteriores no están disponibles en Google.
    • Actualización: Los datos de Google suelen estar listos después de 2 a 3 días. El Agente lee solo los datos finales, hasta tres días antes de hoy, y vuelve a leer los últimos cinco días en cada sincronización.
    • Filas: Google devuelve como máximo 50 000 filas al día, por tipo de búsqueda y por propiedad, ordenadas por clics. Las consultas poco frecuentes (anonimizadas) nunca aparecen como filas, por lo que la suma de filas es inferior a los totales del gráfico de Search Console.
    • Tipos de búsqueda: web, imagen, vídeo, noticias y descubrimiento, cada uno en la columna search_type. Las filas de Descubrimiento no tienen consulta ni dispositivo. Las filas de Noticias no tienen consulta.
    • Cuota: Search Analytics permite 1200 consultas por minuto por propiedad y por usuario, y 40 000 por minuto (30 000 000 por día) por proyecto de Google Cloud, además de un límite de carga que se calcula cada 10 minutos y por día. Las consultas agrupadas por página y consulta en rangos de fechas extensos son las que generan mayor carga, por lo que la primera sincronización de un sitio muy grande puede superar la cuota. El Agente se limita a 60 solicitudes por minuto.
    • Inspección de URL: 2000 inspecciones por día y 600 por minuto por propiedad. Por eso, la tabla url_inspection está desactivada por defecto y solo se ejecuta bajo demanda.
    • Nuevas propiedades: Google puede tardar hasta una semana en generar los datos de un sitio web recién añadido.
    • Claves: hasta 10 claves por cuenta de servicio. Las claves no caducan por defecto, a menos que su organización establezca un plazo máximo de validez.
    • Usuarios: una propiedad puede tener como máximo 100 usuarios que no sean propietarios.
    • Coste: Google no cobra por la API de Search Console.

    Pasos verificados el 8 de octubre de 2026. Fuentes: developers.google.com/webmaster-tools/v1/how-tos/authorizing, developers.google.com/webmaster-tools/v1/prereqs, developers.google.com/webmaster-tools/v1/sites, developers.google.com/webmaster-tools/v1/searchanalytics/…, developers.google.com/webmaster-tools/v1/how-tos/all-your…, developers.google.com/webmaster-tools/limits, developers.google.com/webmaster-tools/pricing, developers.google.com/search/blog/2022/10/performance-dat…, developers.google.com/search/blog/2018/06/new-url-inspect…, developers.google.com/identity/protocols/oauth2/service-a…, docs.cloud.google.com/resource-manager/docs/creating-mana…, docs.cloud.google.com/resource-manager/docs/access-contro…, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/webmasters/answer/7687615?hl=en, support.google.com/webmasters/answer/34592?hl=en, support.google.com/webmasters/answer/96568?hl=en, support.google.com/analytics/answer/10737381?hl=en, docs.airbyte.com/integrations/sources/google-search-console, help.imaginaire.co.uk/books/seo-tool/page/grant-access-to…, victorious.com/blog/google-search-console-add-user, seotesting.com/google-search-console/dominio-vs-prefijo-url, discuss.google.dev/t/problem-with-new-service-accounts/36…, piunikaweb.com/2026/05/01/google-service-account-email-no…, sanj.dev/post/google-analytics-search-console-service-acc…, dev.to/morinaga/what-i-learned-debugging-gsc-url-inspecti….

    Nombre de la conexión
    Cualquier nombre que reconocerás más adelante, como base de datos de ventas.
    Clave JSON de la cuenta de servicio
    Pegue el contenido del archivo de clave de una cuenta de servicio de Google que se haya agregado como usuario en su propiedad de Search Console.
    URL de la propiedad del sitio
    Tu sitio web tal y como aparece en Search Console, por ejemplo, sc-domain:example.com o https://example.com/.

    Haga clic en Probar la conexiónCuando se lee Conectado, haga clic GuardarLa conexión llega a su agente en cuestión de segundos.

    ¿La prueba falló? Por lo general, se trata de un permiso faltante o de una credencial de la cuenta de Search Console incorrecta. El tutorial anterior enumera los problemas comunes y sus soluciones.

  4. See your data in Query Builder Opcional

    You can look at your Search Console account before Google Sheets is involved at all. Open Generador de consultas in the portal and pick the connection you just made. The Esquema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Ejecutar and the rows appear under Resultados. Query Builder is on every plan, Free included.

    On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

  5. Agregar flujos de consultas a Google Sheets

    Abre cualquier hoja de cálculo de Google, ve a Extensiones → Complementos → Obtener complementos, buscar Flujos de consultay haga clic Instale. O instálelo directamente desde Flujos de consultas en el Marketplace de Google WorkspaceGoogle te pedirá que permitas el complemento; eso es normal.

    Después, aparece en cada Hoja de cálculo de Google que abres: un icono de Flujos de consulta en el panel lateral derecho, también listado en ExtensionesNo es necesario iniciar sesión por separado. Reconoce la cuenta de Google que ya estás usando, por lo que el correo electrónico debe ser el mismo que el de tu cuenta de Query Streams.

  6. Trae tu primera mesa

    Haga clic en el icono de Flujos de consulta en el panel lateral a la derecha de la hoja (o búsquelo en Extensiones). Elegir Transmisión de consultas y elige la conexión que acabas de hacer.

    Escriba la consulta que desea ejecutar. Esta extrae algunas columnas de una gsc.search_analytics mesa:

    Ejemplo · SQL
    SELECCIONAR fecha, consulta, clics, impresiones DE gsc.search_analytics ORDENAR POR clics DESC LIMITAR 100;

    Bajo Hoja de destino Seleccione la pestaña en la que deben aparecer las filas y, a continuación, haga clic. Ejecutar consultaLas filas aparecen en esa pestaña en uno o dos segundos. Haga clic en Ejecutar consulta nuevamente cada vez que los datos cambien y la pestaña se actualizará automáticamente.

    ¿No sabes SQL? Build it in Generador de consultas first and paste it here, or pick it from Saved Queries if you saved it.

Eso es todo. Tus datos están en la hoja de cálculo y se actualizan con un solo clic. Solo las filas que solicitaste salieron de tu red.

Buenos pasos a seguir

  • Guardar la consulta en el portal para que puedas ejecutarlo de nuevo con un solo clic, desde Google Sheets o Excel.
  • Agregar un filtro como un rango de fechas, de modo que la misma consulta pueda responder "este mes" sin necesidad de editarla.
  • Comparte los resultados Con un colega. Ellos ven las filas, no tus credenciales.

Preguntas que hace la gente

¿Es necesario que mi cuenta de Search Console esté instalada en el ordenador donde utilizo Hojas de cálculo?

No. Solo el Agente debe estar en la misma ubicación que tu cuenta de Search Console. Google Sheets se ejecuta en tu navegador en cualquier dispositivo. Abre el complemento con la misma cuenta de Google y tus conexiones estarán disponibles.

¿Se copian mis datos a los flujos de consulta?

No. El agente ejecuta la consulta donde se encuentran sus datos y solo envía las filas que devuelve. No se sincroniza ni se almacena nada entretanto.

¿El plan gratuito realmente cubre esto?

Sí. Gratis es un plan que usted conserva, no una prueba que caduca. Vea exactamente lo que incluye en el página de precios.

¿La hoja se actualiza automáticamente?

Haz clic en Ejecutar consulta de nuevo cuando quieras ver las filas más recientes. Para que la hoja se actualice automáticamente según un horario, configura una automatización en el portal de Flujos de consulta (Flujos → Automatización). Esta función está disponible en todos los planes.

¿Sigues atascado? Abrir Ayuda En Query Streams, indíquenos en qué paso se encuentra y qué observa. Le ayudaremos a conectarse.
Query Streams también conecta los mismos datos aExcelClaude, Cursor y ChatGPTuna API RESTy más

Cada guía para Search Console

¿No es exactamente lo que buscas?

  • ¿Quieres más visitas, usuarios y conversiones en tu sitio web que clics en la búsqueda de Google? Google Analytics 4 te ofrece tablas de tráfico diarias directamente desde GA4 → GA4

Setup trouble?

  • Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
Actualizado el octubre 17, 2026

Funciona con BetterDocs