Google Search Console koppelen aan Excel - SEO-gegevens opvragen met SQL

Verbinden · Zoekconsole met Excel

Gegevens ophalen van Zoekconsole naar binnen Excel

Haal live rijen uit je Search Console-account naar Excel en vernieuw ze wanneer je maar wilt. Geen ODBC-stuurprogramma, geen export, geen macro's. De eerste keer duurt het ongeveer tien minuten en het is inbegrepen bij het gratis abonnement.

Ongeveer 10 minuten Geen programmeerkennis vereist Uw inloggegevens blijven bij u. Excel overal, zelfs op het web.

Wat je uiteindelijk overhoudt

Een werkblad met de live resultaten van een SQL-query op uw Search Console-account, met een knop waarmee de meest recente rijen worden opgehaald zodra de gegevens wijzigen. Zoals dit:

Sales.xlsx — Excel

HomeInvoegenGegevensQuery-stromen

	A	B	C	D	E
1	klant_id	voornaam	achternaam	land	totaal
2	1042	Maria	Alvarez	VS	1,284.50
3	1043	Daniël	Okafor	VS	612.00
4	1047	Priya	Nair	VS	2,090.75
5	1051	Thomas	Berg	VS	338.20
6	1056	Lucía	Ferreira	VS	1,455.00
7	1060	Kenji	Sato	VS	874.10
8

Blad1 Live vanuit Search Console

Google Search Console bewaart je gegevens achter een API. Om ze in Excel te krijgen, moet je normaal gesproken elke keer dat je nieuwe cijfers nodig hebt een CSV-bestand exporteren vanuit het Search Console-dashboard. Query Streams maakt dit overbodig: een klein hulpprogramma, de Agent, voert de query uit op de locatie waar je gegevens zich bevinden, en een Excel-invoegtoepassing vraagt de Agent vervolgens om de gewenste rijen. Alleen de resultaten worden verzonden via een versleutelde verbinding, en Excel kan overal zijn: op je laptop thuis, op de computer van een collega aan de andere kant van het land, of via Excel op het web.

Wat je nodig hebt

Een Query Streams-account

Het gratis abonnement is voldoende voor deze handleiding. Meld je aan via mijn.querystreams.nl.

De Agent op elke computer die altijd aan staat.

Een klein programma dat op de achtergrond draait en Search Console aanroept wanneer Excel daarom vraagt. Het enige wat het nodig heeft, is een internetverbinding.

Uw Search Console-aanmelding

U meldt zich eenmalig aan bij Search Console en verleent leesrechten. Er worden geen wachtwoorden ingevoerd in Query Streams.

Verbind het in vijf stappen.

1. Maak uw account aan

   Ga naar mijn.querystreams.nl en meld je aan. Kies de Gratis plan. Het is een echt plan, geen proefversie, en het omvat het koppelen van je Search Console-account en het uitvoeren van zoekopdrachten vanuit Excel.

2. Installeer de agent op een computer die altijd aan staat.

   Aanmelden, openen DownloadInstalleer de agent op een computer of server die altijd aan staat en internettoegang heeft. Dit duurt een minuut en daarna start de agent automatisch.

   Waarom een klein programma in plaats van een driver? De agent is een eenmalige installatie voor Windows, Mac of Linux (ongeveer 85 MB op Windows, iets meer dan 100 MB op Mac en Linux) die stil op de achtergrond draait. Het maakt één uitgaande, versleutelde verbinding met Query Streams, net zoals een browser dat doet, dus u hoeft geen firewallpoort te openen en geen VPN in te stellen. Uw sleutels blijven op die machine en de gegevens worden verzonden naar uw locatie, indien nodig via internet. Het enige dat u hoeft te doen, is de add-in installeren.

   De downloadpagina toont Uw toegangssleutelPlak het in de Agent wanneer daarom wordt gevraagd en wacht tot de badge is weergegeven. Verbonden met querystreamsDat is het enige wat je op de agent zelf doet.

   Complete walkthroughs zijn beschikbaar als je die wilt: Windows, Mac, Linux.

3. Richt het op je Search Console-account.

   Ga terug naar je browser en open... Data Agents (onder Gegevens (in het bovenste menu). Uw makelaar staat daar vermeld. Klik Connector toevoegen en kiezen Google ZoekresultatenHeb je eerst je Search Console-inloggegevens nodig? Open de stappenplan en vul vervolgens de volgende gegevens in:

   Maak uw Search Console-inloggegevens aan. (ongeveer 15 minuten)

   Open vervolgens Google Search Console in een ander tabblad. Query Streams bewaart wat u hier maakt, zodat uw agent het kan gebruiken, en leest alleen gegevens uit Google Search Console.

   Wie kan dit doen?

   Search Console: Eigenaar (geverifieerd of gedelegeerd) van de property, om het serviceaccount als gebruiker toe te voegen. Google Cloud: Eigenaar van het project (u krijgt de rol Eigenaar voor elk project dat u maakt), of de rollen Serviceaccounts maken, Serviceaccountsleutelbeheerder en Servicegebruiksbeheerder.

   Aanbevolen

   De JSON-sleutel van het Google Cloud-serviceaccount (een .json-bestand van het type service_account), waarbij het serviceaccount is toegevoegd als een beperkte gebruiker in de Search Console-eigenschap.

   Voordat je begint

   • Je site is al toegevoegd en geverifieerd in Google Search Console. Het kan tot een week duren voordat Google gegevens heeft voor een gloednieuwe website.
   • Alleen eigenaren hebben toegang tot die Search Console-property. Alleen eigenaren kunnen gebruikers toevoegen. Als u een gebruiker met volledige of beperkte toegang bent, kunt u het Google Cloud-gedeelte (stappen 1 tot en met 12) zelf uitvoeren en een eigenaar vragen om stappen 13 tot en met 17 uit te voeren.
   • Een Google-account waarmee een Google Cloud-project kan worden aangemaakt, of een bestaand project dat u beheert. Als de Google Cloud-organisatie van uw bedrijf op of na 3 mei 2024 is aangemaakt, blokkeert Google standaard belangrijke downloads en moet uw Google Cloud-beheerder deze mogelijk toestaan (zie Veelvoorkomende problemen).
   • Geen factureringsaccount nodig. Google brengt geen kosten in rekening voor de Search Console API.
   • Heb je de Google Analytics 4-connector van Query Streams al ingesteld met een serviceaccount? Je kunt deze hergebruiken: schakel de Search Console API in hetzelfde project in (stap 4) en ga vervolgens naar stap 13 met het e-mailadres van dat serviceaccount. Hetzelfde JSON-sleutelbestand wordt in beide connectors gebruikt.
   • De wizard Query Streams wordt in een nieuw tabblad geopend (Data Agents → Connector toevoegen → Google Search Console) terwijl uw agent online is.

   Stappen

   1. Open 'Resources beheren' in Google Cloud.

      Meld u aan met uw Google-account, open de pagina 'Bronnen beheren' in de Google Cloud-console en klik op 'Project maken'.

      Heb je al een Google Cloud-project dat je wilt gebruiken, bijvoorbeeld het project dat je hebt gemaakt voor de Google Analytics 4-connector? Ga dan direct naar stap 3 en selecteer het daar. De eerste keer dat je Google Cloud opent, kan Google je vragen om je land in te voeren en de servicevoorwaarden te accepteren voordat de pagina wordt weergegeven.

   2. Geef het project een naam en maak het aan.

      Typ in het venster 'Nieuw project' een projectnaam, bijvoorbeeld 'Query Streams Search Console'. Laat het veld voor de bovenliggende organisatie of map leeg, want Google vult dit automatisch in. Als er geen organisatie wordt aangeboden, is dat geen probleem. Klik op 'Maken'.

      Projectnamen bestaan uit 4 tot 30 tekens: letters, cijfers, spaties, koppeltekens, enkele aanhalingstekens en uitroeptekens. U hoeft geen factureringsaccount te kiezen.

   3. Selecteer het project

      Klik op de projectkiezer bovenaan de pagina, naast het Google Cloud-logo, en klik vervolgens op de naam van uw project. Alle onderstaande stappen van Google Cloud vinden plaats binnen dit project.

      De meest voorkomende fout is het inschakelen van de API in het ene project en het aanmaken van de sleutel in een ander project. Controleer de projectnaam bovenaan de pagina vóór elke stap in Google Cloud.

   4. Schakel de Google Search Console API in.

      Open de Google Search Console API-pagina in de API-bibliotheek. Controleer of de naam van uw project bovenaan wordt weergegeven en klik vervolgens op 'Inschakelen'.

      Je kunt er ook komen via API's en services → Bibliotheek: zoek naar de Google Search Console API. Kies niet voor de Indexerings-API of de Siteverificatie-API, want die gebruikt Query Streams niet. Als Google aangeeft dat de API al is ingeschakeld, ga dan verder naar stap 5. Deze ene API dekt alles wat Query Streams leest: je propertylijst, sitemaps, prestatiegegevens en URL-inspectie.

   5. Open de pagina 'Serviceaccount aanmaken'.

      Open de pagina 'Serviceaccount maken'. Vanuit Google Cloud kunt u ook het navigatiemenu (drie streepjes linksboven) openen, IAM & Beheer → Serviceaccounts kiezen en op '+ Serviceaccount maken' klikken.

      Gebruik je het serviceaccount van de Google Analytics 4-connector opnieuw? Maak dan geen tweede account aan. Voer stap 4 uit in het betreffende project en ga vervolgens verder met stap 13 met het bijbehorende e-mailadres.

   6. Geef het serviceaccount een naam.

      Typ bij 'Serviceaccountnaam' query-streams-gsc. Google vult de serviceaccount-ID automatisch in. De beschrijving is optioneel. Klik op 'Maken en doorgaan'.

      De ID kan later niet meer worden gewijzigd. Deze wordt het eerste deel van het e-mailadres van het serviceaccount.

   7. Sla de projectrollen over.

      In het volgende gedeelte worden de rollen binnen het project weergegeven. Laat het vakje voor de rol leeg en klik op Doorgaan.

      Geef het serviceaccount hier geen eigenaar-, editor- of kijkersrechten. De toegang tot uw Search Console-gegevens wordt verleend in Search Console zelf, in stap 16. Een Google Cloud-rol heeft geen effect in Search Console en breidt alleen de mogelijkheden van de sleutel in Google Cloud uit.

   8. Voltooi het aanmaken van het serviceaccount.

      Laat het laatste gedeelte (Rol serviceaccountgebruikers en rol serviceaccountbeheerders) leeg en klik op Voltooien. U bent terug in de lijst met serviceaccounts.

   9. Kopieer het e-mailadres van het serviceaccount

      Zoek in de lijst het nieuwe account. Het e-mailadres ziet eruit als [email protected]. Kopieer dit adres en bewaar het voor stap 16.

      Kopieer het volledige adres, tot en met .iam.gserviceaccount.com. Hetzelfde adres staat in het sleutelbestand van stap 12, op de regel client_email. Google geeft aan dat het een minuut of langer kan duren voordat een nieuw serviceaccount bruikbaar is.

   10. Open het tabblad 'Toetsen'.

       Klik op het e-mailadres van het serviceaccount en vervolgens op het tabblad 'Sleutels'.

   11. Start een nieuwe sleutel

       Klik op 'Sleutel toevoegen' en kies vervolgens 'Nieuwe sleutel maken'.

       Als er een venster verschijnt met de titel 'Aanmaken van serviceaccountsleutels is uitgeschakeld', blokkeert uw organisatie het downloaden van sleutels. Zie Veelvoorkomende problemen.

   12. Download de JSON-sleutel

       Kies JSON als sleuteltype en klik op 'Maken'. Je browser downloadt een .json-bestand, meestal naar je map 'Downloads'.

       Deze download is eenmalig: u kunt hetzelfde bestand niet opnieuw downloaden. Als u het kwijtraakt, maak dan een nieuwe sleutel aan en verwijder de oude. Kies niet voor P12. Houd het bestand privé. Verstuur het niet via e-mail en plaats het niet in een gedeelde map, want iedereen die het bestand heeft, kan deze Search Console-gegevens lezen. Query Streams slaat het bestand op voor uw agent en leest het alleen zelf.

   13. Open Search Console en selecteer de woning.

       Open Google Search Console en log in als eigenaar van de site. Selecteer in het vervolgkeuzemenu 'Property' linksboven de property die u door Query Streams wilt laten lezen.

       Als de site twee keer wordt vermeld, één keer als kale naam (example.com) en één keer als adres (https://www.example.com/), dan is de kale naam de domeineigenschap. Deze omvat alle subdomeinen en zowel http als https, dus is dit meestal de juiste keuze.

   14. Gebruikers en machtigingen openen

       Scrol in het menu aan de linkerkant naar beneden en klik op Instellingen. Klik vervolgens op Gebruikers en machtigingen.

       Alleen eigenaren van onroerend goed kunnen gebruikers en machtigingen zien. Als dit er niet staat, bent u een gebruiker met volledige of beperkte toegang: stuur de e-mail uit stap 9 naar een eigenaar van het onroerend goed en vraag hem of haar om de stappen 13 tot en met 17 uit te voeren.

   15. Klik op Gebruiker toevoegen

       Klik rechtsboven op de pagina Gebruikers en machtigingen op Gebruiker toevoegen. Het venster Gebruiker toevoegen wordt geopend.

   16. Voer het e-mailadres van het serviceaccount in en kies 'Beperkt'.

       Plak het e-mailadres van het serviceaccount uit stap 9 in het veld 'E-mailadres'. Open de lijst met machtigingen en kies 'Beperkt'.

       Beperkt is voldoende: Google laat gebruikers met beperkte toegang alle rapporten bekijken, inclusief prestatierapporten, en URL-inspectie gebruiken. Volledig werkt ook. In beide gevallen vraagt de agent Google alleen om leesrechten, dus kan deze geen sitemaps verzenden, URL's verwijderen of instellingen wijzigen.

   17. Voeg het serviceaccount toe

       Klik op Toevoegen. Het serviceaccount wordt nu weergegeven in de gebruikerslijst van de accommodatie met Beperkte toegangsrechten.

       Als Search Console het adres niet accepteert (bijvoorbeeld omdat het e-mailadres niet overeenkomt met een Google-account of niet is gevonden), raadpleeg dan de veelvoorkomende problemen. Google heeft sinds april 2026 een bekend probleem met nieuw aangemaakte serviceaccounts.

   18. Let op hoe de eigenschap is geschreven.

       Kijk naar de naam van de eigenschap in het keuzemenu. Een kale naam zoals example.com is een domeineigenschap: u voert deze in als sc-domain:example.com. Een volledig adres zoals https://www.example.com/ is een URL-prefixeigenschap: u voert deze exact zo in, met dezelfde http of https, dezelfde www of geen www, en de schuine streep aan het einde.

       Nog eenvoudiger: de knop 'Detecteren' in de wizard 'Querystreams' geeft de exacte waarden voor u weer. Als u https://example.com/ typt terwijl de eigenschap https://www.example.com/ is, of als u de laatste schuine streep weglaat, verwijst u naar een eigenschap die het serviceaccount niet kan lezen.

   Toestemmingen verlenen

   Bron	Toegang	Gebruikt voor
   Gebruikersmachtigingen in Search Console (Instellingen → Gebruikers en machtigingen)	Beperkt (Volledig werkt ook)	Elke gsc-tabel: search_analytics (prestatiegegevens: klikken, impressies, CTR en positie per datum, zoekopdracht, pagina, land en apparaat), sites en sitemaps, allemaal standaard ingeschakeld, plus url_inspection (standaard uitgeschakeld, wordt op aanvraag uitgevoerd). Google laat gebruikers met beperkte toegang alle rapporten bekijken en URL-inspectie gebruiken.
   Google Cloud API: Google Search Console API	Ingeschakeld	Test de verbinding, de knop 'Detecteren' en elke gsc-tabel. Zonder deze tests geeft Google bij elk verzoek een 403-foutmelding.
   OAuth-bereik https://www.googleapis.com/auth/webmasters.readonly	Op verzoek van de agent (u hoeft niets in te stellen)	Elke gsc-tabel, test de verbinding en detecteer. Google beschrijft dit bereik als alleen-lezen toegang, dus de agent kan geen sitemaps verzenden, URL's verwijderen of instellingen wijzigen.
   Google Cloud-projectrol voor het serviceaccount	Geen	Geen enkele tabel heeft er een nodig. Toegang tot de zoekconsole wordt alleen verleend via de hierboven vermelde gebruikersrechten.
   Eigenaar van Search Console (de persoon die de installatie uitvoert, niet het serviceaccount)	Eigenaar (geverifieerd of gedelegeerd)	Geen tabel. Alleen eigenaren kunnen gebruikers aan een woning toevoegen.

   Plakken in querystreams

   Service Account JSON-sleutel

   Het volledige .json-bestand uit stap 12. Klik op 'Uploaden vanaf deze computer' onder het vak en selecteer het bestand (of 'Vanuit een bestand op de agent...' als het bestand zich op de agentcomputer bevindt). Of open het bestand in Kladblok (TextEdit op een Mac), selecteer alles, kopieer en plak het van de eerste { tot de laatste }. Wanneer u de connector later bewerkt, laat u dit vak leeg om de opgeslagen sleutel te behouden, of plaatst u een volledig nieuw bestand om deze te vervangen.

   URL van de site-eigenschap

   Klik op 'Detecteren' naast het vak zodra de sleutel is ingevoerd (uw agent moet online zijn). Het vak wordt een lijst met alle eigenschappen die het serviceaccount kan zien, zoals sc-domain:example.com — siteRestrictedUser. Kies uw eigenschap. Of typ deze in zoals berekend in stap 18: sc-domain:example.com voor een domeineigenschap, of het volledige adres met de schuine streep aan het einde, zoals https://www.example.com/, voor een URL-prefixeigenschap.

   Veelvoorkomende problemen

   De testverbinding mislukt met de foutmelding 'Ongeldig sleuteltype. Verwacht 'service_account'.'

   Waarom: Het bestand is geen serviceaccountsleutel. Meestal is het een OAuth-clientbestand (met een naam zoals client_secret_….json) of een API-sleutel uit API's en services → Referenties.

   Repareren: Maak een JSON-sleutel aan voor het serviceaccount (stappen 10 tot en met 12) en gebruik dat bestand. Een serviceaccountsleutel bevat de regel “type”: “service_account”.

   De testverbinding mislukt met de melding 'Ongeldig JSON-formaat' of 'Ontbrekend of leeg veld 'private_key' in de serviceaccountsleutel'.

   Waarom: Slechts een deel van het bestand is gekopieerd, of de tekst is tijdens het kopiëren gewijzigd.

   Repareren: Klik op 'Uploaden vanaf deze computer' en selecteer het .json-bestand in plaats van te kopiëren. Of open het bestand opnieuw in Kladblok (TextEdit op een Mac), druk op Ctrl+A (Cmd+A op een Mac), kopieer en plak zonder iets ervoor of erna te plakken.

   De verbindingstest mislukt met de melding dat het serviceaccount '...' geen Search Console-eigenschappen heeft, of dat er bij 'Detecteren' niets is gedetecteerd.

   Waarom: Search Console heeft het serviceaccount nog niet aan een property toegevoegd. Stappen 13 tot en met 17 zijn overgeslagen, op een andere site uitgevoerd of Search Console heeft de e-mail geweigerd.

   Repareren: Voeg het exacte e-mailadres uit stap 9 toe als gebruiker aan de property (stappen 13 tot en met 17). Controleer of het nu wordt weergegeven in Gebruikers en machtigingen en klik vervolgens opnieuw op Testen.

   De testverbinding mislukt met de foutmelding 'Serviceaccount '...' heeft geen toegang. Voeg het toe aan de Search Console-eigenschap.', ook al staat het serviceaccount wel vermeld in Gebruikers en machtigingen. Detect kan de volgende melding van Google weergeven: 'De Google Search Console API is nog niet eerder gebruikt in project ... of is uitgeschakeld.'

   Waarom: De Google Search Console API is niet ingeschakeld in het Google Cloud-project waartoe de sleutel behoort (de regel `project_id` in het sleutelbestand). Google weigert deze aanroepen met een 403-fout, wat volgens de test duidt op ontbrekende toegang.

   Repareren: Selecteer dat project in Google Cloud, schakel de Google Search Console API in (stap 4), wacht een paar minuten en klik opnieuw op Testen.

   De verbindingstest geeft aan dat de verbinding tot stand is gebracht, maar gsc.search_analytics blijft leeg en het agentlogboek toont een foutmelding van de Search Analytics API: Verboden.

   Waarom: De URL van de site-eigenschap komt niet exact overeen met een eigenschap waaraan het serviceaccount is toegevoegd: sc-domein: versus https://, www versus geen www, http versus https, of een ontbrekende schuine streep aan het einde. De test controleert alleen of het serviceaccount ten minste één eigenschap kan zien. De synchronisatie leest de eigenschap die u hebt ingevoerd.

   Repareren: Open in Data Agents de connector en klik op Bewerken. Klik op Detecteren naast Site Property URL, selecteer de property uit de lijst, klik op Verbinding testen en vervolgens op Wijzigingen opslaan.

   Search Console kan het serviceaccount niet toevoegen. Er verschijnt de melding dat het e-mailadres niet overeenkomt met een Google-account, of 'Gebruiker toevoegen mislukt: e-mailadres niet gevonden'.

   Waarom: Een bekend probleem bij Google: sinds eind april 2026 herkennen Search Console en Google Analytics soms tijdelijk geen nieuw aangemaakte serviceaccounts. Ontwikkelaars hebben dit probleem tot september 2026 gemeld. Een typefout of een spatie in het adres leidt tot dezelfde foutmelding.

   Repareren: Plak het adres opnieuw, zonder spaties. Als het nog steeds wordt geweigerd, wacht dan een paar uur en probeer het opnieuw. Een eerder aangemaakt serviceaccount werkt meestal wel: als u er een heeft (bijvoorbeeld van de Google Analytics 4-connector), voeg dan het bijbehorende e-mailadres toe en gebruik het sleutelbestand.

   Google Cloud geeft aan dat het aanmaken van serviceaccountsleutels is uitgeschakeld wanneer u op 'Nieuwe sleutel aanmaken' klikt.

   Waarom: Uw organisatie handhaaft het beleid iam.disableServiceAccountKeyCreation. Google schakelt dit standaard in voor organisaties die op of na 3 mei 2024 zijn aangemaakt.

   Repareren: Vraag uw Google Cloud-beheerder (iemand met de rol Organisatiebeleidsbeheerder) om dit project van het beleid uit te zonderen. Google beschrijft een uitzondering op basis van tags voor een enkel project. Herhaal vervolgens stap 11 en 12.

   Een connector die voorheen wel werkte, synchroniseert niet meer en de testverbinding mislukt met de foutmelding: … invalid_grant … Ongeldige JWT-handtekening.

   Waarom: De sleutel is verwijderd, uitgeschakeld of verlopen in Google Cloud.

   Repareren: Maak een nieuwe sleutel aan (stappen 10 tot en met 12). Open in Data Agents de connector, klik op Bewerken, plaats het nieuwe bestand in Service Account JSON Key, klik op Verbinding testen en vervolgens op Wijzigingen opslaan. Verwijder de oude sleutel in Google Cloud.

   De testverbinding mislukt met een foutmelding die invalid_grant en Invalid JWT vermeldt: Token must be a short-lived token.

   Waarom: De klok op de Agent-computer loopt enkele minuten achter. Google weigert aanmeldingen vanaf een computer waarvan de tijd niet klopt.

   Repareren: Schakel de automatische (internet)tijd in op de agentcomputer en klik vervolgens opnieuw op Testen.

   Het aantal klikken en vertoningen in gsc.search_analytics is lager dan wat de prestatiegrafiek van Search Console laat zien.

   Waarom: Google laat zeldzame (geanonimiseerde) zoekopdrachten buiten elk rij-voor-rij-antwoord, terwijl ze wel in de totalen van de grafiek worden meegerekend. Google retourneert bovendien maximaal 50.000 rijen per dag per zoektype voor elke eigenschap. Een URL-prefix-eigenschap dekt ook een kleiner deel van de site dan de domeineigenschap.

   Repareren: Er is niets mis. Vergelijk de rijtotalen met de tabel in Search Console in plaats van met het totaal in de grafiek, en selecteer de eigenschap 'Domein' als u de hele site wilt vergelijken.

   De gegevens van de afgelopen twee of drie dagen ontbreken in gsc.search_analytics.

   Waarom: De gegevens van Google zijn doorgaans 2 tot 3 dagen later beschikbaar. De Agent leest alleen de definitieve gegevens van Google, tot maximaal drie dagen voor vandaag.

   Repareren: Niets te veranderen. Die dagen worden bij latere synchronisaties meegerekend. Bij elke synchronisatie worden ook de gegevens van de afgelopen vijf dagen opnieuw ingelezen, zodat late wijzigingen worden meegenomen.

   Je wilt dat Query Streams stopt met het lezen van deze eigenschap.

   Waarom: Het verwijderen van de connector heft de toegang van Google niet op. Het serviceaccount blijft een gebruiker en de sleutel blijft geldig.

   Repareren: In Search Console → Instellingen → Gebruikers en machtigingen, open het menu naast het serviceaccount en klik op Toegang verwijderen. Open in Google Cloud het tabblad Sleutels van het serviceaccount en verwijder de sleutel. Verwijder vervolgens de connector in Data Agents.

   Grenzen aan wat je kunt weten

   • Geschiedenis: Search Console bewaart de gegevens van de afgelopen 16 maanden. Bij de eerste synchronisatie van de agent worden alle 16 maanden gelezen; gegevens van oudere dagen zijn niet beschikbaar via Google.
   • Actualiteit: De gegevens van Google zijn doorgaans na 2 tot 3 dagen beschikbaar. De Agent leest alleen de meest recente gegevens, tot maximaal drie dagen voor vandaag, en leest de gegevens van de afgelopen vijf dagen opnieuw bij elke synchronisatie.
   • Rijen: Google retourneert maximaal 50.000 rijen per dag per zoektype, per property, gesorteerd op klikken. Zeldzame (geanonimiseerde) zoekopdrachten worden nooit als rijen weergegeven, waardoor het aantal rijen lager is dan de totalen in de grafieken van Search Console.
   • Zoektypen: web, afbeelding, video, nieuws en ontdekken, elk in de kolom search_type. Rijen met 'Ontdekken' hebben geen zoekopdracht of apparaat. Rijen met 'Nieuws' hebben geen zoekopdracht.
   • Quota: Search Analytics staat 1200 zoekopdrachten per minuut per property en per gebruiker toe, en 40.000 per minuut (30.000.000 per dag) per Google Cloud-project, plus een belastinglimiet die per 10 minuten en per dag wordt berekend. Zoekopdrachten die gegroepeerd zijn per pagina en zoekopdracht over lange datumbereiken belasten het meest, waardoor de eerste synchronisatie van een zeer grote site al tot een quotumoverschrijding kan leiden. De agent beperkt zichzelf tot 60 aanvragen per minuut.
   • URL-inspectie: 2000 inspecties per dag en 600 per minuut per object. Daarom is de tabel url_inspection standaard uitgeschakeld en wordt deze alleen op aanvraag uitgevoerd.
   • Nieuwe eigenschappen: Het kan tot een week duren voordat Google gegevens heeft voor een nieuw toegevoegde site.
   • Sleutels: maximaal 10 sleutels per serviceaccount. Sleutels verlopen standaard nooit, tenzij uw organisatie een maximale levensduur instelt.
   • Gebruikers: een woning kan maximaal 100 gebruikers hebben die geen eigenaar zijn.
   • Kosten: Google brengt geen kosten in rekening voor de Search Console API.

   Stappen geverifieerd op 8 oktober 2026. Bronnen: 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/domain-vs-url-prefix, 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….

   Verbindingsnaam

   Elke naam die je later zult herkennen, zoals 'Verkoopdatabase'.

   Service Account JSON-sleutel

   Plak hier de inhoud van het sleutelbestand voor een Google-serviceaccount dat als gebruiker is toegevoegd aan uw Search Console-property.

   URL van de site-eigenschap

   Uw site precies zoals deze in Search Console wordt weergegeven, bijvoorbeeld sc-domain:example.com of https://example.com/.

   Klik op TestverbindingWanneer er staat Aangesloten, klik SlaDe verbinding bereikt uw agent binnen enkele seconden.

   Open Data Agents

   Test mislukt? Meestal gaat het om een ontbrekende machtiging of inloggegevens van het verkeerde Search Console-account. De bovenstaande stappen beschrijven de oorzaak. veelvoorkomende problemen en de oplossingen daarvoor.

4. See your data in Query Builder Optioneel

   You can look at your Search Console account before Excel is involved at all. Open Querybouwer 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 Ren and the rows appear under Resultaten. 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-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Querystreams toevoegen aan Excel

   Ga in Excel naar Invoegen → Invoegingen ophalen, zoeken naar Query-stromenen klik ToevoegenOf open het direct vanuit Querystreams op Microsoft AppSourceEr verschijnt een knop 'Query Streams' in het lint. Meld u aan met hetzelfde account.

   Werkt in Excel voor Microsoft 365 op Windows en Mac, en in Excel op het web.

6. Schuif je eerste tafel aan

   Klik op de knop Query Streams en kies Een query streamenen kies de verbinding die je zojuist hebt gemaakt.

   Typ de query die u wilt uitvoeren. Deze haalt een paar kolommen op uit een gsc.search_analytics tafel:

   Voorbeeld · SQL

   SELECT date, query, clicks, impressies FROM gsc.search_analytics ORDER BY clicks DESC LIMIT 100;

   Onder Bestemmingsblad kiezen Maak een nieuw werkblad aanDruk vervolgens op de afspeelknop (de ▶-pijl). De rijen verschijnen binnen een seconde of twee in Excel. Druk er nogmaals op wanneer de gegevens zijn gewijzigd en het werkblad wordt direct bijgewerkt.

   Weet je niet wat SQL is? Build it in Querybouwer first and paste it here, or pick it from Saved Queries if you saved it.

Goede volgende stappen

• Sla de zoekopdracht op. In het portaal kunt u het vervolgens met één klik opnieuw uitvoeren, vanuit Excel of Google Sheets.
• Voeg een filter toe zoals een datumbereik, zodat dezelfde zoekopdracht "deze maand" kan antwoorden zonder aanpassingen.
• Deel de resultaten met een collega. Zij zien de rijen, niet je inloggegevens.

Vragen die mensen stellen

Gerelateerde handleidingen

• Google Search Console naar Google Spreadsheets
• Stripe naar Microsoft Excel
• HubSpot naar Microsoft Excel
• Shopify naar Microsoft Excel
• SQL-query's uitvoeren in Excel
• Alle handleidingen