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.

Da Google Search Console a Fogli Google (2026) - Dati SEO in tempo reale, senza codice

Collega Search Console a Fogli Google

Ottieni i dati da Console di ricerca in Fogli di Google

Importa i dati in tempo reale dal tuo account Search Console in Fogli Google e aggiornali quando vuoi. Nessun caricamento di file CSV, nessun Apps Script, nessun copia-incolla. La prima volta ci vogliono circa dieci minuti, ed è incluso nel piano gratuito.

Circa 10 minuti Non è necessaria alcuna programmazione. Le credenziali restano con te Qualsiasi browser, qualsiasi dispositivo

Hai bisogno di aiuto? Chiedi pure a noi. Apri Supporto Accedi a Query Streams (menu in alto a destra → Supporto) e inviaci un messaggio. Persone reali lo leggono, e "Non so cosa mi stia chiedendo questa schermata" è una domanda assolutamente legittima.

Quello che otterrai alla fine

Un foglio Google che mostra i risultati in tempo reale di una query SQL sul tuo account Search Console, con un pulsante che visualizza le righe più recenti ogni volta che i dati cambiano. Ad esempio:

Vendite Salvato su Drive

FileModificareVisualizzazioneInserisciFormatoDatiUtensiliEstensioniAiuto

	A	B	C	D	E
1	ID cliente	nome di battesimo	cognome	Paese	totale
2	1042	Maria	Alvarez	U.S.A.	1,284.50
3	1043	Daniel	Okafor	U.S.A.	612.00
4	1047	Priya	Nair	U.S.A.	2,090.75
5	1051	Tommaso	Berg	U.S.A.	338.20
6	1056	Lucia	Ferreira	U.S.A.	1,455.00
7	1060	Kenji	Sato	U.S.A.	874.10
8

+ clienti Foglio1

In diretta dalla Search Console

Google Search Console protegge i tuoi dati tramite la sua API. Importarli in Fogli Google di solito significa esportare un file CSV dalla dashboard di Search Console ogni volta che hai bisogno di dati aggiornati. Query Streams elimina questo passaggio: un piccolo programma di supporto chiamato Agent esegue la query direttamente dove si trovano i tuoi dati e un componente aggiuntivo per Fogli Google richiede le righe desiderate. Solo i risultati vengono trasmessi, tramite un link crittografato, e Fogli Google può essere consultato ovunque: su qualsiasi browser e dispositivo.

L'agente vive con i tuoi dati. Il tuo foglio di calcolo risiede nel cloud di Google. Aprilo ovunque e le righe saranno a tua disposizione.

Cosa ti servirà

Un account Query Streams

Il piano gratuito è sufficiente per questa guida. Registrati su my.querystreams.com.

L'agente su qualsiasi computer sempre acceso

Un piccolo programma che viene eseguito in background e richiama Search Console quando Google Sheets lo richiede. Richiede solo una connessione a Internet.

Le tue credenziali di accesso a Search Console

Dovrai accedere a Search Console una sola volta e consentire l'accesso in lettura. Non è necessario inserire password in Query Streams.

Quale computer riceve l'agente? Qualsiasi dispositivo sempre acceso in grado di accedere al tuo account Search Console. Google Sheets può essere ovunque; funziona nel tuo browser.

Collegalo in cinque passaggi

Crea il tuo account

Vai a my.querystreams.com e iscriviti. Scegli il Gratuito piano. Si tratta di un piano reale, non di una versione di prova, che include la connessione al tuo account Search Console e l'esecuzione di query da Fogli Google.
Installa l'agente su qualsiasi computer sempre acceso.
Accedi, apri Scaricamentoe installa l'agente su qualsiasi computer o server sempre acceso con accesso a Internet. L'operazione richiede un minuto e da quel momento in poi si avvia automaticamente.
Perché un piccolo programma invece di un driver? L'Agent è un'unica installazione per Windows, Mac o Linux (circa 85 MB su Windows, poco più di 100 MB su Mac e Linux) che funziona silenziosamente in background. Stabilisce una connessione in uscita crittografata con Query Streams, nello stesso modo di un browser, quindi non è necessario aprire porte del firewall né configurare una VPN. Le chiavi rimangono sul computer e le righe vengono inviate ovunque vi troviate, anche tramite Internet se necessario. L'unico componente aggiuntivo di cui dovrete occuparvi è l'Agent stesso.
La pagina di download mostra La tua chiave di accesso. Incollalo nell'Agente quando richiesto e attendi che il badge venga letto Connesso ai flussi di queryQuesta è l'unica operazione che si esegue sull'agente stesso.
Se volete, potete trovare le guide complete: Finestre, Mac, Linux.

Puntalo al tuo account Search Console

Torna al tuo browser, apri Agenti dati (Sotto Dati nel menu in alto). Il tuo agente è elencato lì. Fai clic Aggiungi connettore e scegliere Google Search ConsoleHai bisogno prima delle credenziali di Search Console? Apri la procedura guidata, quindi inserisci i dati richiesti:

Crea le tue credenziali di Search Console (circa 15 minuti)

Dopodiché, apri Google Search Console in un'altra scheda. Query Streams conserva le informazioni create qui, in modo che il tuo agente possa utilizzarle, e legge esclusivamente da Google Search Console.

Chi può farlo?: Search Console: Proprietario (verificato o delegato) della proprietà, per aggiungere l'account di servizio come utente. Google Cloud: Proprietario del progetto (si ottiene il ruolo di Proprietario su qualsiasi progetto creato) oppure i ruoli Crea account di servizio, Amministratore chiave account di servizio e Amministratore utilizzo servizio su di esso.
Raccomandato: Chiave JSON dell'account di servizio Google Cloud (un file .json di tipo service_account), con l'account di servizio aggiunto come utente con restrizioni nella proprietà Search Console.

Prima di iniziare

Il tuo sito è già stato aggiunto e verificato in Google Search Console. Per una nuova proprietà, potrebbero essere necessarie fino a sette giorni prima che Google disponga di dati al riguardo.
Accesso del proprietario alla proprietà di Search Console. Solo i proprietari possono aggiungere utenti. Se sei un utente con accesso completo o limitato, puoi completare la parte relativa a Google Cloud (passaggi da 1 a 12) e chiedere a un proprietario di completare i passaggi da 13 a 17.
Un account Google che può creare un progetto Google Cloud o un progetto esistente che gestisci. Se l'organizzazione Google Cloud della tua azienda è stata creata a partire dal 3 maggio 2024, Google blocca per impostazione predefinita il download delle chiavi e potrebbe essere necessario che l'amministratore di Google Cloud le autorizzi (vedi Problemi comuni).
Nessun account di fatturazione. Google non addebita alcun costo per l'API di Search Console.
Hai già configurato il connettore di Query Streams per Google Analytics 4 con un account di servizio? Puoi riutilizzarlo: abilita l'API di Search Console nello stesso progetto (passaggio 4), quindi vai al passaggio 13 con l'indirizzo email di quell'account di servizio. Lo stesso file chiave JSON va utilizzato in entrambi i connettori.
La procedura guidata Query Streams si aprirà in un'altra scheda (Agenti dati → Aggiungi connettore → Google Search Console) con il tuo agente online.

Passaggi

Apri Gestisci le risorse in Google Cloud
Accedi con il tuo account Google, apri la pagina Gestisci risorse della console Google Cloud e fai clic su Crea progetto.
Hai già un progetto Google Cloud che desideri utilizzare, ad esempio quello creato per il connettore di Google Analytics 4? Passa direttamente al passaggio 3 e selezionalo da lì. La prima volta che apri Google Cloud, Google potrebbe chiederti di specificare il tuo Paese e di accettare i Termini di servizio prima di visualizzare la pagina.
Assegna un nome e crea il progetto
Nella finestra Nuovo progetto, digita un nome per il progetto, ad esempio Query Streams Search Console. Lascia il campo Organizzazione o cartella principale così come viene compilato da Google. Se non viene offerta alcuna organizzazione, non preoccuparti. Fai clic su Crea.
I nomi dei progetti devono avere una lunghezza compresa tra 4 e 30 caratteri: lettere, numeri, spazi, trattini, virgolette singole e punti esclamativi. Non è necessario selezionare un account di fatturazione.
Seleziona il progetto
Fai clic sul selettore del progetto nella parte superiore della pagina, accanto al logo di Google Cloud, e fai clic sul nome del tuo progetto. Tutti i passaggi di Google Cloud descritti di seguito vengono eseguiti all'interno di questo progetto.
L'errore più comune è quello di abilitare l'API in un progetto e creare la chiave in un altro. Verifica il nome del progetto nella parte superiore della pagina prima di ogni passaggio in Google Cloud.
Abilita l'API di Google Search Console
Apri la pagina dell'API di Google Search Console nella Libreria API. Verifica che il nome del tuo progetto venga visualizzato in alto, quindi fai clic su Abilita.
Puoi accedervi anche da API e servizi → Libreria: cerca "Google Search Console API". Non selezionare "Indexing API" o "Site Verification API", che Query Streams non utilizza. Se Google indica che l'API è già abilitata, passa al passaggio 5. Questa singola API copre tutto ciò che Query Streams legge: l'elenco delle proprietà, le sitemap, i dati sulle prestazioni e l'ispezione degli URL.
Apri la pagina Crea account di servizio
Apri la pagina Crea account di servizio. In alternativa, da Google Cloud puoi aprire il menu di navigazione (tre linee in alto a sinistra), scegliere IAM e amministrazione → Account di servizio e fare clic su + Crea account di servizio.
Stai riutilizzando l'account di servizio del connettore Google Analytics 4? Non crearne un secondo. Esegui il passaggio 4 nel progetto corrispondente, quindi passa al passaggio 13 utilizzando il relativo indirizzo email.
Assegna un nome all'account di servizio
Nel campo "Nome account di servizio", digita query-streams-gsc. Google compilerà automaticamente l'ID dell'account di servizio. La descrizione è facoltativa. Fai clic su "Crea e continua".
L'ID non può essere modificato in seguito. Diventa la prima parte dell'indirizzo email dell'account di servizio.
Salta i ruoli del progetto
La sezione successiva propone i ruoli disponibili nel progetto. Lascia vuoto il campo relativo al ruolo e fai clic su Continua.
Non assegnare all'account di servizio i ruoli di Proprietario, Editor o Visualizzatore. L'accesso ai dati di Search Console viene concesso all'interno di Search Console al passaggio 16. Un ruolo di Google Cloud non ha alcun effetto in Search Console e si limita ad ampliare le funzionalità della chiave in Google Cloud.
Completare la creazione dell'account di servizio
Lascia vuota l'ultima sezione (Ruolo utenti account di servizio e Ruolo amministratori account di servizio) e fai clic su Fine. Tornerai all'elenco degli account di servizio.
Copia l'email dell'account di servizio
Nell'elenco, individua il nuovo account. Il suo indirizzo email ha un formato simile a [email protected]. Copialo e conservalo per il passaggio 16.
Copia l'intero indirizzo, fino a .iam.gserviceaccount.com. Lo stesso indirizzo è presente nel file chiave del passaggio 12, sulla riga client_email. Google afferma che un nuovo account di servizio potrebbe impiegare un minuto o più prima di essere utilizzabile.
Apri la scheda Tasti
Fai clic sull'indirizzo e-mail dell'account di servizio, quindi fai clic sulla scheda Chiavi.
Avvia una nuova chiave
Fai clic su Aggiungi chiave, quindi scegli Crea nuova chiave.
Se viene visualizzata una finestra di dialogo intitolata "La creazione della chiave dell'account di servizio è disabilitata", la tua organizzazione blocca il download delle chiavi. Vedi Problemi comuni.
Scarica la chiave JSON
Seleziona JSON come tipo di chiave e fai clic su Crea. Il tuo browser scaricherà un file .json, solitamente nella cartella Download.
Questo download avviene una sola volta: non è possibile scaricare nuovamente lo stesso file. Se lo perdi, crea una nuova chiave ed elimina quella vecchia. Non scegliere P12. Mantieni il file privato. Non inviarlo via e-mail né inserirlo in una cartella condivisa, perché chiunque lo possieda può leggere i dati di Search Console. Query Streams lo memorizza per il tuo agente e lo legge solo tramite quest'ultimo.
Apri Search Console e seleziona la proprietà
Apri Google Search Console, accedendo come proprietario del sito. Nel menu a tendina "Proprietà" in alto a sinistra, seleziona la proprietà che desideri che Query Streams legga.
Se il sito è elencato due volte, una volta come nome semplice (example.com) e una volta come indirizzo (https://www.example.com/), il nome semplice rappresenta la proprietà del dominio. Copre tutti i sottodomini e sia http che https, quindi di solito è quello da scegliere.
Utenti e permessi aperti
Nel menu a sinistra, scorri verso il basso e fai clic su Impostazioni. Quindi fai clic su Utenti e autorizzazioni.
Solo i proprietari degli immobili possono visualizzare Utenti e autorizzazioni. Se questa sezione non è presente, significa che sei un utente con autorizzazioni complete o limitate: invia l'email del passaggio 9 a un proprietario dell'immobile e chiedigli di eseguire i passaggi da 13 a 17.
Fai clic su Aggiungi utente
Nella pagina Utenti e autorizzazioni, fai clic su Aggiungi utente in alto a destra. Si aprirà la finestra Aggiungi utente.
Inserisci l'indirizzo email dell'account di servizio e scegli Limitato
Incolla l'indirizzo email dell'account di servizio dal passaggio 9 nel campo Indirizzo email. Apri l'elenco delle autorizzazioni e seleziona Limitato.
L'accesso limitato è sufficiente: Google consente agli utenti con accesso limitato di visualizzare tutti i report, incluso quello sulle prestazioni, e di utilizzare l'ispezione URL. Anche l'accesso completo funziona. In entrambi i casi, l'agente richiede a Google solo l'accesso in sola lettura, quindi non può inviare sitemap, rimuovere URL o modificare le impostazioni.
Aggiungi l'account di servizio
Fai clic su Aggiungi. L'account di servizio ora viene visualizzato nell'elenco utenti della struttura con autorizzazioni limitate.
Se Search Console non accetta l'indirizzo (ad esempio, perché dice che l'email non corrisponde a un account Google o non è stata trovata), consulta la sezione Problemi comuni. Google ha riscontrato un problema noto con gli account di servizio appena creati a partire da aprile 2026.
Nota come è scritta la proprietà
Osserva il nome della proprietà nel menu a tendina delle proprietà. Un nome semplice come example.com è una proprietà di tipo Dominio: dovrai inserirlo come sc-dominio:example.com. Un indirizzo completo come https://www.example.com/ è una proprietà di tipo Prefisso URL: dovrai inserirlo esattamente come mostrato, con lo stesso http o https, lo stesso www o senza www e la barra finale.
Ancora più semplice: il pulsante Rileva nella procedura guidata Query Streams elenca i valori esatti. Digitando https://example.com/ quando la proprietà è https://www.example.com/ o omettendo l'ultima barra, si fa riferimento a una proprietà che l'account di servizio non può leggere.

Autorizzazioni a concedere

Risorsa	Accesso	Utilizzato per
Autorizzazioni utente di Search Console (Impostazioni → Utenti e autorizzazioni)	Accesso limitato (anche la versione completa funziona)	Ogni tabella gsc: search_analytics (dati sulle prestazioni: clic, impressioni, CTR e posizione per data, query, pagina, paese e dispositivo), siti e sitemap, tutti attivi per impostazione predefinita, più url_inspection (disattivato per impostazione predefinita, eseguibile su richiesta). Google consente agli utenti con restrizioni di visualizzare tutti i report e utilizzare l'ispezione URL.
API di Google Cloud: API di Google Search Console	Abilitato	Verifica la connessione, il pulsante Rileva e ogni tabella gsc. Senza di esso, Google restituisce un errore 403 a ogni chiamata.
Ambito OAuth https://www.googleapis.com/auth/webmasters.readonly	Richiesto dall'agente (non devi impostare nulla)	Ogni tabella gsc, Test connessione e Rileva. Google descrive questo ambito come accesso di sola lettura, quindi l'agente non può inviare sitemap, rimuovere URL o modificare alcuna impostazione.
Ruolo di progetto Google Cloud per l'account di servizio	Nessuno	Nessuna tabella ne ha bisogno. L'accesso alla Search Console è consentito solo tramite l'autorizzazione utente sopra indicata.
Proprietario della Search Console (la persona che esegue la configurazione, non l'account di servizio)	Titolare (verificato o delegato)	Nessuna tabella. Solo i proprietari possono aggiungere utenti a una proprietà.

Incolla nei flussi di query

Chiave JSON dell'account di servizio: L'intero file .json del passaggio 12. Fai clic su Carica da questo computer sotto la casella e seleziona il file (oppure Da un file sull'agente... se il file si trova sul computer dell'agente). In alternativa, apri il file con Blocco note (TextEdit su Mac), seleziona tutto, copia e incolla il contenuto dalla prima { all'ultima }. Quando modifichi il connettore in seguito, lascia questa casella vuota per mantenere la chiave memorizzata oppure inserisci un file completamente nuovo per sostituirla.
URL della proprietà del sito: Fai clic su Rileva accanto alla casella una volta inserita la chiave (il tuo agente deve essere online). La casella si trasformerà in un elenco di tutte le proprietà che l'account di servizio può visualizzare, ad esempio sc-domain:example.com — siteRestrictedUser. Seleziona la tua. Oppure digitala come calcolato al passaggio 18: sc-domain:example.com per una proprietà di tipo Dominio, oppure l'indirizzo completo con la barra finale, ad esempio https://www.example.com/, per una proprietà di tipo Prefisso URL.

Problemi comuni

Il test di connessione non riesce con l'errore "Tipo di chiave non valido. Previsto 'service_account'".

Perché: Il file non è una chiave di account di servizio. Solitamente si tratta di un file client OAuth (con un nome del tipo client_secret_….json) o di una chiave API che si trova in API e servizi → Credenziali.

Aggiustare: Crea una chiave JSON sull'account di servizio (passaggi da 10 a 12) e utilizza quel file. Una chiave dell'account di servizio contiene la riga "type": "service_account".

Il test di connessione fallisce a causa di un formato JSON non valido oppure a causa di un campo 'private_key' mancante o vuoto nella chiave dell'account di servizio.

Perché: È stata copiata solo una parte del file oppure il testo è stato modificato durante la copia.

Aggiustare: Fai clic su Carica da questo computer e seleziona il file .json anziché copiarlo. In alternativa, apri nuovamente il file in Blocco note (TextEdit su Mac), premi Ctrl+A (Cmd+A su Mac), copia e incolla senza aggiungere altro testo prima o dopo.

Il test di connessione non riesce con l'account di servizio '…' che non ha proprietà nella Search Console oppure con il comando Detect che indica "Nessun rilevamento".

Perché: Search Console non ha ancora aggiunto l'account di servizio ad alcuna proprietà. I passaggi da 13 a 17 sono stati saltati, eseguiti su un sito diverso oppure Search Console ha rifiutato l'e-mail.

Aggiustare: Aggiungi l'indirizzo email esatto del passaggio 9 come utente della proprietà (passaggi da 13 a 17). Verifica che ora venga visualizzato in Utenti e autorizzazioni, quindi fai di nuovo clic su Test.

Il test di connessione non riesce con l'account di servizio '…' che non dispone delle autorizzazioni necessarie. Aggiungilo alla proprietà di Search Console., anche se l'account di servizio è elencato in Utenti e autorizzazioni. Il rilevamento potrebbe mostrare il messaggio di Google: L'API di Google Search Console non è stata utilizzata in precedenza nel progetto … oppure è disabilitata.

Perché: L'API di Google Search Console non è abilitata nel progetto Google Cloud a cui appartiene la chiave (la riga project_id nel file della chiave). Google rifiuta queste chiamate con un errore 403, che il test segnala come accesso mancante.

Aggiustare: Seleziona quel progetto in Google Cloud, abilita l'API di Google Search Console (passaggio 4), attendi qualche minuto e fai di nuovo clic su Test.

Il test di connessione indica "Connesso", ma gsc.search_analytics rimane vuoto e il registro dell'agente mostra l'errore dell'API di Search Analytics: Accesso negato.

Perché: L'URL della proprietà del sito non corrisponde esattamente a una proprietà a cui è stato aggiunto l'account di servizio: sc-domain: anziché https://, www anziché nessun www, http anziché https, oppure manca una barra finale. Il test verifica solo che l'account di servizio possa visualizzare almeno una proprietà. La sincronizzazione legge quella che hai digitato.

Aggiustare: In Data Agents, apri il connettore e fai clic su Modifica. Fai clic su Rileva accanto a URL proprietà sito, seleziona la proprietà dall'elenco, fai clic su Verifica connessione, quindi su Salva modifiche.

Search Console non riesce ad aggiungere l'account di servizio. Viene visualizzato il messaggio "L'indirizzo email non corrisponde a un account Google" oppure "Impossibile aggiungere l'utente: indirizzo email non trovato".

Perché: Un problema noto di Google: dalla fine di aprile 2026, Search Console e Google Analytics a volte non riconoscono gli account di servizio appena creati per un certo periodo. Gli sviluppatori hanno segnalato il problema fino a settembre 2026. Un errore di battitura o uno spazio nell'indirizzo generano lo stesso messaggio.

Aggiustare: Incolla nuovamente l'indirizzo senza spazi. Se viene ancora rifiutato, attendi qualche ora e riprova. Un account di servizio creato in precedenza di solito funziona: se ne possiedi uno (ad esempio, dal connettore di Google Analytics 4), inserisci il relativo indirizzo email e utilizza il file chiave.

Google Cloud mostra che la creazione della chiave dell'account di servizio è disabilitata quando si fa clic su Crea nuova chiave.

Perché: La tua organizzazione applica la policy iam.disableServiceAccountKeyCreation. Google la attiva per impostazione predefinita per le organizzazioni create a partire dal 3 maggio 2024.

Aggiustare: Chiedi al tuo amministratore di Google Cloud (una persona con il ruolo di Amministratore delle Norme dell'Organizzazione) di esentare questo progetto dalle norme. Google documenta un'esenzione basata su tag per un singolo progetto. Quindi ripeti i passaggi 11 e 12.

Un connettore che prima funzionava smette di sincronizzarsi e il test di connessione fallisce con l'errore di connessione: … invalid_grant … Firma JWT non valida.

Perché: La chiave è stata eliminata, disabilitata o è scaduta in Google Cloud.

Aggiustare: Crea una nuova chiave (passaggi da 10 a 12). In Data Agents, apri il connettore, fai clic su Modifica, inserisci il nuovo file in Chiave JSON dell'account di servizio, fai clic su Verifica connessione, quindi Salva modifiche. Elimina la vecchia chiave in Google Cloud.

Il test di connessione fallisce con un errore che menziona invalid_grant e Invalid JWT: il token deve essere un token di breve durata.

Perché: L'orologio del computer dell'agente è sfasato di diversi minuti. Google rifiuta gli accessi da un computer con l'ora errata.

Aggiustare: Attiva l'ora automatica (Internet) sul computer dell'agente, quindi fai nuovamente clic su Test.

Il totale dei clic e delle impressioni in gsc.search_analytics è inferiore a quello mostrato nel grafico delle prestazioni di Search Console.

Perché: Google esclude le query rare (anonimizzate) da ogni risposta riga per riga, mentre i totali del grafico le includono comunque. Google restituisce inoltre al massimo 50.000 righe al giorno per tipo di ricerca per ogni proprietà. Una proprietà di prefisso URL copre anche una porzione minore del sito rispetto alla proprietà di dominio.

Aggiustare: Non c'è niente di rotto. Confronta le somme delle righe con la tabella di Search Console anziché con il totale del grafico e seleziona la proprietà Dominio se desideri l'intero sito.

Gli ultimi due o tre giorni mancano da gsc.search_analytics.

Perché: I dati di Google sono generalmente disponibili da 2 a 3 giorni dopo l'evento. L'agente legge solo i dati finali di Google, relativi al periodo massimo di tre giorni precedenti la data odierna.

Aggiustare: Non c'è nulla da modificare. Quei giorni arriveranno nelle sincronizzazioni successive. Ogni sincronizzazione rilegge anche gli ultimi cinque giorni, quindi le modifiche tardive vengono rilevate.

Desideri che Query Streams smetta di leggere questa proprietà.

Perché: L'eliminazione del connettore non revoca l'accesso a Google. L'account di servizio rimane un utente e la chiave resta valida.

Aggiustare: In Search Console → Impostazioni → Utenti e autorizzazioni, apri il menu accanto all'account di servizio e fai clic su Rimuovi accesso. In Google Cloud, apri la scheda Chiavi dell'account di servizio ed elimina la chiave. Quindi elimina il connettore in Data Agents.

Limiti da conoscere

Cronologia: Search Console conserva i dati degli ultimi 16 mesi. La prima sincronizzazione dell'agente legge tutti i 16 mesi; i dati precedenti non sono disponibili da Google.
Aggiornamento: i dati di Google sono generalmente pronti dopo 2 o 3 giorni. L'agente legge solo i dati finali, fino a tre giorni prima di oggi, e rilegge gli ultimi cinque giorni a ogni sincronizzazione.
Righe: Google restituisce al massimo 50.000 righe al giorno, per tipo di ricerca e per proprietà, ordinate per clic. Le query rare (anonimizzate) non vengono mai visualizzate come righe, quindi la somma delle righe è inferiore ai totali del grafico di Search Console.
Tipi di ricerca: web, immagini, video, notizie e Discover, ciascuno nella colonna search_type. Le righe di Discover non hanno query o dispositivo. Le righe di News non hanno query.
Quota: Search Analytics consente 1.200 query al minuto per proprietà e per utente, e 40.000 al minuto (30.000.000 al giorno) per progetto Google Cloud, oltre a un limite di carico conteggiato ogni 10 minuti e al giorno. Le query raggruppate per pagina e query su intervalli di date lunghi comportano il maggior carico, pertanto la prima sincronizzazione di un sito molto grande potrebbe superare la quota. L'agente gestisce automaticamente un massimo di 60 richieste al minuto.
Ispezione URL: 2.000 ispezioni al giorno e 600 al minuto per proprietà. Per questo motivo la tabella url_inspection è disattivata per impostazione predefinita e viene eseguita solo su richiesta.
Nuove proprietà: Google può impiegare fino a una settimana per generare i dati relativi a un sito appena aggiunto.
Chiavi: fino a 10 chiavi per account di servizio. Le chiavi non scadono mai per impostazione predefinita, a meno che la tua organizzazione non imposti una durata massima.
Utenti: una proprietà può avere al massimo 100 utenti che non sono proprietari.
Costo: Google non addebita alcun costo per l'API di Search Console.

Nome della società: Un nome che riconoscerai in seguito, come ad esempio "Database delle vendite".
Chiave JSON dell'account di servizio: Incolla il contenuto del file chiave per un account di servizio Google che è stato aggiunto come utente alla tua proprietà Search Console.
URL della proprietà del sito: Il tuo sito esattamente come viene visualizzato in Search Console, ad esempio sc-dominio:esempio.com o https://esempio.com/.

Cliccare Verifica la connessioneQuando legge Collegato, clicca RisparmiareLa connessione raggiunge il tuo agente in pochi secondi.

Agenti di dati aperti

Test fallito? Solitamente si tratta di un'autorizzazione mancante o di credenziali provenienti dall'account Search Console sbagliato. La procedura guidata sopra elenca le problemi comuni e le relative soluzioni.

See your data in Query Builder Opzionale

You can look at your Search Console account before Google Sheets is involved at all. Open Generatore di query in the portal and pick the connection you just made. The Schema 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 Correre and the rows appear under Risultati. 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.
Aggiungere Query Streams a Fogli Google

Apri un qualsiasi foglio Google, vai a Estensioni → Componenti aggiuntivi → Ottieni componenti aggiuntivi, cerca Flussi di querye clicca InstallareOppure installalo direttamente da Query Streams sul Google Workspace MarketplaceGoogle ti chiederà di autorizzare l'installazione del componente aggiuntivo; è normale.

Successivamente è presente in ogni Foglio Google che apri: un'icona di Query Streams nel pannello laterale a destra, elencata anche sotto EstensioniNon è necessario effettuare un accesso separato. Il sistema riconosce l'account Google che già utilizzi, quindi l'indirizzo email deve essere lo stesso associato al tuo account Query Streams.
Porta il tuo primo tavolo

Fai clic sull'icona Query Streams nel pannello laterale a destra del foglio (oppure trovala sotto Estensioni). Scegliere Streamer di query e seleziona la connessione appena stabilita.

Digita la query che vuoi eseguire. Questa estrae alcune colonne da un gsc.search_analytics tavolo:
Esempio · SQL
```
SELECT date, query, clicks, impressions FROM gsc.search_analytics ORDER BY clicks DESC LIMIT 100;
```
Sotto Scheda di destinazione seleziona la scheda in cui devono finire le righe, quindi fai clic Eseguire la queryLe righe vengono visualizzate in quella scheda in uno o due secondi. Fai clic su "Esegui query" ogni volta che i dati sono cambiati e la scheda si aggiornerà automaticamente.

Non conosci SQL? Build it in Generatore di query first and paste it here, or pick it from Saved Queries if you saved it.

Questo è tutto. I tuoi dati sono presenti nel foglio di calcolo e rimangono aggiornati con un solo clic. Nulla ha lasciato la tua rete, a parte le righe che hai richiesto.

Buone mosse successive

Salva la query nel portale, così puoi eseguirlo di nuovo con un solo clic, da Fogli Google o Excel.
Aggiungi un filtro come ad esempio un intervallo di date, in modo che la stessa query possa rispondere "questo mese" senza modifiche.
Condividi i risultati con un collega. Loro vedono le righe, non le tue credenziali.

Domande che le persone si pongono

Il mio account Search Console deve necessariamente trovarsi sullo stesso computer che utilizzo per Fogli Google?

No. Solo l'agente deve trovarsi nella stessa posizione del tuo account Search Console. Google Sheets funziona nel tuo browser su qualsiasi dispositivo. Apri il componente aggiuntivo con lo stesso account Google e troverai le tue connessioni.

I miei dati vengono copiati in Query Streams?

No. L'agente esegue la query nel luogo in cui si trovano i tuoi dati e invia solo le righe restituite. Nulla viene sincronizzato o memorizzato nel frattempo.

Il piano gratuito copre davvero tutto questo?

Sì. La versione gratuita è un piano che mantieni, non una prova che scade. Scopri esattamente cosa include su pagina dei prezzi.

Il foglio si aggiorna automaticamente?

Fai clic su "Esegui query" ogni volta che desideri visualizzare le righe più recenti. Per un foglio di calcolo che si aggiorni automaticamente a intervalli regolari senza alcun intervento umano, configura un'automazione nel portale Query Streams (Streams → Automazione). Questa opzione è disponibile in tutti i piani.

Ancora bloccato? Apri Supporto Accedi a Query Streams e comunicaci a quale passaggio ti trovi e cosa visualizzi. Ti aiuteremo a connetterti.

Crea il tuo account per il piano gratuito Scopri cosa include la versione gratuita

Query Streams collega anche gli stessi dati aExcel Claude, Cursor e ChatGPT un'API REST e altro ancora

Ogni guida per Search Console

Non è proprio la tua configurazione?

Preferisci visite, utenti e conversioni sul tuo sito anziché clic dalla ricerca di Google? Google Analytics 4 fornisce tabelle di traffico giornaliere direttamente da 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?

Quello che otterrai alla fine

Cosa ti servirà

Un account Query Streams

L'agente su qualsiasi computer sempre acceso

Le tue credenziali di accesso a Search Console

Collegalo in cinque passaggi

Crea il tuo account

Installa l'agente su qualsiasi computer sempre acceso.

Puntalo al tuo account Search Console

Prima di iniziare

Passaggi

Autorizzazioni a concedere

Incolla nei flussi di query

Problemi comuni

Limiti da conoscere

See your data in Query Builder Opzionale

Aggiungere Query Streams a Fogli Google

Porta il tuo primo tavolo

Buone mosse successive

Domande che le persone si pongono

Guide correlate

Condividi questo articolo :