Visualizza le categorie

Come collegare Google Search Console a Google Sheets - Interrogare i dati SEO con SQL

7 minuti di lettura

Query Streams collega Google Search Console a Google Sheets, trasformando i tuoi dati di ricerca organica in tabelle live interrogabili tramite SQL che puoi aggiornare su richiesta. Importa classifiche delle parole chiave, impressioni, percentuali di clic e prestazioni a livello di pagina in qualsiasi foglio di calcolo Google Sheets, senza esportazioni CSV manuali né codifica API. Iscriviti gratuitamente su QueryStreams.com e inizia ad analizzare i tuoi dati GSC con SQL in pochi minuti.

5 Tabelle GSC

Analisi delle ricerche, query più frequenti, pagine, paesi e dispositivi

Servizio Autorizzazione del conto

Nessun flusso browser OAuth: incolla una chiave JSON per l'autenticazione headless

Crittografato con AES-256

Le credenziali del tuo account di servizio rimangono sulla tua rete, mai nel cloud

Storia di 16 mesi

Accedi a fino a 16 mesi di dati GSC oltre il limite standard di 3 mesi dell'UI.

A quali dati di Google Search Console puoi accedere?

Query Streams sincronizza i dati relativi alle prestazioni di ricerca di GSC in tabelle interrogabili tramite SQL. I dati GSC presentano in genere un ritardo di 2-3 giorni rispetto alla pipeline di elaborazione di Google.

Analisi delle ricerche

  • analisi_ricerca Clic giornalieri, impressioni, CTR e posizione per query
  • query_più_frequenti Parole chiave principali con metriche relative alle impressioni e al CTR
  • pagine principali Prestazioni di ricerca a livello di pagina con classifiche

Ripartizione del pubblico

  • per_paese Analisi delle ricerche segmentate per paese
  • per_dispositivo Prestazioni di ricerca su desktop, dispositivi mobili e tablet

Nota sui dati

  • I dati GSC hanno un ritardo di elaborazione di 2-3 giorni da parte di Google.
  • Sono disponibili fino a 16 mesi di dati storici (rispetto ai 3 mesi nell'interfaccia utente GSC).
  • I dati vengono aggregati: le singole sessioni degli utenti non vengono tracciate.

Colonne chiave

  • query La parola chiave di ricerca che ha attivato il tuo URL
  • clic Numero di clic dalla ricerca Google
  • impressioni Numero di volte in cui il tuo URL è apparso nei risultati di ricerca
  • ctr Tasso di clic (clic / impressioni)
  • posizione Posizione media nei risultati di ricerca

Prerequisiti

1
Conto flussi di query

Iscriviti gratuitamente — non è richiesta alcuna carta di credito

2
Agente di rete per i flussi di query

Servizio Windows installato sulla tua rete. Guida all'installazione

3
Progetto Google Cloud

Con l'API di Google Search Console abilitata e una proprietà GSC verificata

4
Account di servizio Google

File chiave JSON con l'account di servizio aggiunto come utente verificato in GSC

5
Fogli di Google

Con il componente aggiuntivo Query Streams installato da Google Workspace Marketplace

Guida all'installazione

1Installare l'agente
2Account di servizio
3Aggiungi connettore
4Programma di sincronizzazione
5Installa componente aggiuntivo

Passaggio 1: installare Query Streams Network Agent

  1. Accedi a my.querystreams.com
  2. Vai a Agenti di rete nella barra laterale sinistra
  3. Cliccare Scarica agente ed eseguire il programma di installazione di Windows
  4. L'agente si installa come servizio Windows e si connette automaticamente.
  5. Il tuo agente appare come "Online" nel portale entro 30 secondi.

Passaggio 2: creare un account Google Cloud Service

  1. Vai al Console Google Cloud e creare o selezionare un progetto
  2. Vai a API e serviziBiblioteca → cerca e attiva API di Google Search Console
  3. Vai a IAM e amministrazioneAccount di servizioCrea account di servizio
  4. Assegnagli un nome (ad esempio, "query-streams-gsc") e clicca su Crea e continua
  5. Salta l'assegnazione del ruolo opzionale → clicca Fatto
  6. Clicca sull'account di servizio → Chiavi scheda → Aggiungi chiaveCrea nuova chiaveJSON
  7. Il file chiave JSON viene scaricato automaticamente: salvalo in modo sicuro.

Concedi l'accesso in Google Search Console

  1. Vai a Google Search Console e seleziona la tua proprietà
  2. Cliccare ImpostazioniUtenti e autorizzazioni
  3. Cliccare Aggiungi utente
  4. Incolla il indirizzo_e-mail_del_cliente dal tuo file chiave JSON
  5. Imposta l'autorizzazione su Completo → clicca Aggiungi

Passaggio 3: aggiungi il connettore Google Search Console

  1. Apri l'interfaccia dell'agente di rete all'indirizzo http://localhost:1823
  2. Cliccare Aggiungi connessione e seleziona Google Search Console
  3. Incolla il contenuto del tuo Chiave JSON dell'account di servizio (oppure carica il file)
  4. Seleziona il tuo GSC Immobiliare dal menu a tendina (proprietà dominio o prefisso URL)
  5. Cliccare Avanti per configurare le pianificazioni di sincronizzazione e installare query predefinite

Passaggio 4: configurare la pianificazione della sincronizzazione

Analisi delle ricerche (giornaliera)Ricerche, pagine, paesi e dispositivi più frequenti: sincronizzati quotidianamente con un ritardo di 3-4 giorni.
Sincronizzazione inizialeRecupera fino a 16 mesi di dati storici al primo avvio

I dati GSC sono in genere ritardati di 2-3 giorni rispetto alla pipeline di elaborazione di Google. La sincronizzazione giornaliera è l'ideale: una sincronizzazione più frequente non produrrà nuovi risultati. La sincronizzazione iniziale recupera fino a 16 mesi di dati storici, offrendoti una cronologia molto più ampia rispetto al limite di 3 mesi nell'interfaccia utente GSC.

Passaggio 5: installa il componente aggiuntivo Google Sheets

  1. Apri Google Sheets nel tuo browser
  2. Vai a EstensioniComponenti aggiuntiviOttieni componenti aggiuntivi
  3. Cerca "Flussi di query"
  4. Cliccare Installare e concedere le autorizzazioni richieste
  5. Accedi tramite EstensioniFlussi di queryApri
  6. Accedi con le credenziali del tuo account Query Streams
  7. Oppure installare direttamente: Installare i flussi di query per Google Sheets

Sei connesso! Apri i flussi di query in Fogli Google, fai clic su Query salvatee trova la cartella Google Search Console con query predefinite per il posizionamento delle parole chiave, l'analisi CTR, le prestazioni delle pagine e altro ancora. Seleziona una query qualsiasi e fai clic su Correre per importare i dati GSC in tempo reale nel tuo foglio di calcolo.

Esempio di query SQL di Google Search Console

Parole chiave principali per numero di clic (ultimi 30 giorni)
SELECT
    query,
    SUM(clicks) AS total_clicks,
    SUM(impressions) AS total_impressions,
    ROUND(AVG(ctr) * 100, 2) AS avg_ctr_pct,
    ROUND(AVG(position), 1) AS avg_position
FROM gsc.search_analytics
WHERE date >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY query
ORDER BY total_clicks DESC
LIMIT 25;
Pagine appena fuori dalla pagina 1 (posizione 11-20)
SELECT
    pagina,
    SUM(clic) AS clic,
    SUM(impressioni) AS impressioni,
    ROUND(AVG(ctr) * 100, 2) AS ctr_pct,
    ROUND(AVG(posizione), 1) AS posizione_media
FROM gsc.top_pages
WHERE date >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY page
HAVING ROUND(AVG(position), 1) BETWEEN 11 AND 20
ORDER BY impressions DESC
LIMIT 20;
Parole chiave ad alto impatto e basso CTR (opportunità CTR)
SELECT
    query,
    SUM(impressions) AS impressioni,
    SUM(clicks) AS clic,
    ROUND(AVG(ctr) * 100, 2) AS ctr_pct,
    ROUND(AVG(position), 1) AS posizione_media
FROM gsc.search_analytics
WHERE date >= CURRENT_DATE - INTERVAL '90 days'
GROUP BY query
HAVING SUM(impressions) > 500
   AND AVG(ctr) < 0.03
ORDER BY impressions DESC
LIMIT 20;

Condividi i rapporti SEO senza condividere l'accesso a GSC

Apri qualsiasi query GSC nel Query Builder → clicca sul Condivisione scheda → inserisci indirizzi e-mail → clicca CondividiI destinatari ricevono i dati relativi alle parole chiave e al posizionamento nel loro componente aggiuntivo di Google Sheets, senza avere accesso alla tua proprietà Google Search Console, alle credenziali dell'account di servizio o al codice SQL.

Domande frequenti

Posso ottenere più di 3 mesi di dati GSC?
Sì. L'API di Google Search Console fornisce fino a 16 mesi di dati storici. Query Streams recupera questa cronologia completa durante la sincronizzazione iniziale, fornendo molti più dati rispetto al limite di 3 mesi disponibile nell'interfaccia web di GSC: l'ideale per l'analisi delle tendenze, i confronti anno su anno e i report SEO stagionali.
Perché i miei dati GSC sono sempre in ritardo di qualche giorno?
Si tratta di una limitazione della piattaforma Google. L'elaborazione dei dati GSC ha un ritardo di 2-3 giorni prima di diventare disponibile tramite l'API. Ciò influisce su tutti gli strumenti che leggono dall'API di Search Console, non solo su Query Streams. La sincronizzazione giornaliera tiene conto di questo ritardo in modo appropriato.
Posso collegare più proprietà GSC?
Sì. Aggiungi un connettore separato per ogni proprietà GSC. Ogni proprietà appare come una fonte di dati distinta nel generatore di query, quindi puoi interrogare e persino confrontare le prestazioni organiche di più siti web in un'unica istruzione SQL direttamente in Google Sheets.
Posso combinare i dati GSC con Google Analytics nella stessa query?
Sì. Se hai collegato sia Google Search Console che Google Analytics 4, puoi UNIRLI tramite l'URL della pagina in un'unica query SQL, correlando le impressioni di ricerca e il CTR di GSC con le metriche di coinvolgimento sul sito, come la durata della sessione e la frequenza di rimbalzo di GA4.

Guide correlate

Categoria: Connettori API

Tag: Google Search Console, GSC, Fogli Google, SEO, Parole chiave, Classifiche, SQL, Ricerca organica

Meta Description: Collega Google Search Console a Google Sheets con SQL. Richiedi classifiche delle parole chiave, CTR e 16 mesi di dati di ricerca, senza bisogno di esportazioni CSV.

Updated on 3 giugno 2026

Powered by BetterDocs