
Met de Google GA API haal je automatisch rapportgegevens uit Google Analytics 4, zoals sessies, verkeersbronnen en omzet. Hiervoor gebruik je de Google Analytics Data API, met toegang tot je Analytics-property en een verzoek waarin je de gewenste gegevens opgeeft.
Inhoudsopgave
Zo hoef je niet steeds rapporten te downloaden of cijfers over te typen. Je kunt gegevens verwerken in een dashboard, spreadsheet of eigen applicatie. De koppeling wordt vooral nuttig wanneer je regelmatig dezelfde vragen stelt: welke kanalen brengen bezoekers, welke pagina’s leveren aanvragen op en waar ontstaat omzet?
Bij IWolf verbinden we professionele websites en SEO met meetbare doelen. Voor een MKB-bedrijf in Tiel, Utrecht of elders in Nederland begint dat niet bij een ingewikkeld dashboard, maar bij betrouwbare metingen. Hieronder leggen we uit hoe de koppeling werkt, hoe je gegevens opvraagt en waar verschillen in rapportages vandaan komen.

Google GA API is een veelgebruikte zoekterm, maar geen officiële productnaam. Google biedt verschillende interfaces voor Analytics. Welke je nodig hebt, hangt af van je doel: rapporten uitlezen, instellingen beheren of gebeurtenissen versturen.
| Onderdeel | Wat doet het? | Wanneer gebruik je het? |
|---|---|---|
| Google Analytics Data API | Leest rapportgegevens uit GA4, zoals gebruikers, sessies en omzet. | Voor dashboards, periodieke rapportages en eigen analyses. |
| Google Analytics Admin API | Beheert ondersteunde instellingen van accounts en properties. | Voor automatisering van bijvoorbeeld property- en gegevensstreambeheer. |
| Measurement Protocol | Verstuurt gebeurtenissen naar Google Analytics. | Voor aanvullende metingen vanuit een server of ander systeem. |
| BigQuery-export | Exporteert gebeurtenisgegevens naar een datawarehouse. | Voor analyses op gebeurtenisniveau en koppelingen met andere databronnen. |
Wil je bestaande cijfers uit GA4 ophalen? Dan is de Data API doorgaans het juiste vertrekpunt. Het Measurement Protocol is daarvoor niet bedoeld: daarmee stuur je gegevens naar Analytics, in plaats van rapporten terug te lezen.
Online staan nog handleidingen voor de Core Reporting API en Analytics Reporting API van Universal Analytics. Daarin zie je bijvoorbeeld een view-ID of veldnamen zoals ga:sessions. Die aanpak hoort niet bij GA4.
De huidige rapportage werkt met een GA4-property-ID en veldnamen zoals sessions en activeUsers. Controleer dus eerst voor welk Analytics-product een codevoorbeeld geschreven is. Dat voorkomt dat je een oude integratie probeert te repareren die fundamenteel niet past.
De meerwaarde zit vooral in herhaalbaarheid. Je definieert een rapport één keer en laat je applicatie daarna dezelfde gegevens ophalen. Daardoor kun je trends volgen zonder telkens handmatig filters en datumbereiken in te stellen.
Een praktisch voorbeeld is een dienstverlener die veel bezoekers op informatiepagina’s krijgt. Alleen het aantal sessies zegt weinig over het zakelijke resultaat. Door landingspagina’s, verkeersbronnen en relevante gebeurtenissen naast elkaar te bekijken, wordt duidelijker waar geïnteresseerde bezoekers verdergaan.
Voor gerichte zoekmachineoptimalisatie helpt dat om prioriteiten te stellen. Een pagina met veel verkeer en weinig aanvragen vraagt mogelijk om een andere vervolgstap, niet automatisch om meer bezoekers.
Een koppeling maakt ontbrekende metingen niet alsnog beschikbaar. Als je website geen formulierverzending registreert, kan de API die aanvraag ook niet rapporteren. Hetzelfde geldt voor onjuist gemeten aankopen of ontbrekende campagneparameters.
Bij een nieuwe website hoort daarom ook de vraag wat je wilt meten. Denk aan een daadwerkelijk geslaagd formulier, niet alleen aan een klik op de verzendknop. Dat onderscheid voorkomt dat mislukte pogingen als aanvragen meetellen.

Bij de Google GA API beschrijf je welke doorsnede van je gegevens je wilt ontvangen. Een verzoek bestaat meestal uit een property, een periode, dimensies en statistieken. Filters en sortering verfijnen het resultaat.
Een dimensie beschrijft een kenmerk, zoals een datum, landingspagina of verkeersbron. Een statistiek is een meetwaarde, zoals het aantal sessies of de omzet. De combinatie bepaalt wat iedere rij in je rapport betekent.
date: de datum waarop de gerapporteerde activiteit plaatsvond.sessionSourceMedium: de bron en het medium die aan een sessie zijn gekoppeld.landingPagePlusQueryString: de landingspagina inclusief eventuele queryparameters.sessions: het aantal sessies.engagedSessions: het aantal sessies dat aan de criteria voor betrokkenheid voldoet.keyEvents: het aantal geregistreerde belangrijke gebeurtenissen.totalRevenue: de totale omzet volgens de definitie van GA4.Niet elke dimensie past bij elke statistiek. Bovendien zijn omzet, aankopen en belangrijke gebeurtenissen geen uitwisselbare begrippen. Controleer de velddefinities voordat je er zakelijke conclusies aan verbindt.
GA4 onderscheidt verschillende meetniveaus. firstUserSourceMedium beschrijft bijvoorbeeld de bron waarmee een gebruiker voor het eerst is binnengekomen. sessionSourceMedium beschrijft de bron op sessieniveau.
Een bezoeker kan eerst via Google zoeken en later via een nieuwsbrief terugkomen. Die twee dimensies kunnen dan verschillende antwoorden geven, zonder dat één ervan fout is. Kies het niveau dat aansluit op je vraag: eerste kennismaking, huidig bezoek of toekenning van een resultaat.
Voor een eigen serverkoppeling is een serviceaccount vaak praktisch. Dat is een technische identiteit waarmee je toepassing toegang krijgt. Onderstaand stappenplan gaat uit van zo’n koppeling voor een GA4-property die je zelf beheert.
G-.Google beschrijft de actuele methoden en velden in de documentatie van de Data API. Gebruik die documentatie als referentie bij het bouwen en onderhouden van de integratie.
Een serviceaccount past bij een achtergrondproces met vooraf geregelde toegang. OAuth is logischer wanneer verschillende klanten met hun eigen Google-account toestemming moeten geven aan jouw toepassing.
Met OAuth blijven de rechten gekoppeld aan de gebruiker en diens toestemming. Daar horen ook beheer van tokens, intrekken van toegang en mogelijk verificatie van je toepassing bij. Kies de authenticatiemethode dus op basis van het gebruik, niet alleen op basis van het kortste codevoorbeeld.
Met Python kun je de Google GA API aanroepen en het resultaat naar een CSV-bestand schrijven. Het onderstaande voorbeeld haalt sessies en betrokken sessies op per datum en bron/medium, over de afgelopen zeven volledige dagen.
Installeer eerst de officiële clientbibliotheek:
pip install google-analytics-data
Voor een lokale test met een JSON-sleutel stel je daarna omgevingsvariabelen in. Onderstaand voorbeeld gebruikt de syntaxis van een Linux- of macOS-terminal. Vul je eigen bestandspad en property-ID in.
export GOOGLE_APPLICATION_CREDENTIALS="/veilig/pad/service-account.json"
export GA4_PROPERTY_ID="JOUW_NUMERIEKE_PROPERTY_ID"
Het script gebruikt Application Default Credentials. Daardoor kan dezelfde authenticatieaanpak ook werken zonder lokaal sleutelbestand, wanneer je productieomgeving een geschikte service-identiteit aanbiedt.
import csv
import os
from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import (
DateRange,
Dimension,
Metric,
OrderBy,
RunReportRequest,
)
property_id = os.environ["GA4_PROPERTY_ID"]
client = BetaAnalyticsDataClient()
offset = 0
page_size = 10000
with open("ga4-verkeer.csv", "w", newline="", encoding="utf-8") as file:
writer = csv.writer(file)
writer.writerow([
"date",
"sessionSourceMedium",
"sessions",
"engagedSessions",
])
while True:
request = RunReportRequest(
property=f"properties/{property_id}",
date_ranges=[
DateRange(start_date="7daysAgo", end_date="yesterday")
],
dimensions=[
Dimension(name="date"),
Dimension(name="sessionSourceMedium"),
],
metrics=[
Metric(name="sessions"),
Metric(name="engagedSessions"),
],
order_bys=[
OrderBy(
dimension=OrderBy.DimensionOrderBy(
dimension_name="date"
)
),
OrderBy(
dimension=OrderBy.DimensionOrderBy(
dimension_name="sessionSourceMedium"
)
),
],
limit=page_size,
offset=offset,
return_property_quota=True,
)
response = client.run_report(request)
for row in response.rows:
writer.writerow(
[value.value for value in row.dimension_values]
+ [value.value for value in row.metric_values]
)
offset += len(response.rows)
if not response.rows or offset >= response.row_count:
break
print("Rapport opgeslagen in ga4-verkeer.csv")
Iedere rij bevat een datum, een combinatie van bron en medium en de bijbehorende meetwaarden. De API geeft waarden als tekst terug. Voor berekeningen moet je aantallen of bedragen daarom naar het passende gegevenstype omzetten.
Het script verwerkt ook paginering: als het resultaat niet in één antwoord past, vraagt het volgende delen op met offset. De gekozen paginagrootte is een instelling van dit voorbeeld, geen uitspraak over het maximale aantal toegestane rijen.
De vaste sortering maakt de volgorde voorspelbaar. Rapportgegevens kunnen tijdens verwerking alsnog veranderen. Voor een reproduceerbare export kun je daarom beter vaste datums gebruiken en de opgehaalde gegevens met een ophaaltijdstip bewaren.
Dit is een basisvoorbeeld. Voor productie voeg je onder meer foutafhandeling, veilige opslag en controle van de responsmetadata toe. Controleer ook CSV-waarden voordat je bestanden automatisch in spreadsheetsoftware opent: tekst uit externe bronnen mag daar niet onbedoeld als formule worden uitgevoerd.
Hulp nodig hierbij? IWolf denkt graag met je mee.
Een klein rapport is makkelijker te controleren dan een export met alle beschikbare velden. Begin bij een concrete vraag, zoals: welke organische landingspagina’s leiden tot relevante interacties?
Met een dimensiefilter beperk je het rapport bijvoorbeeld tot organisch verkeer of een specifieke gebeurtenis. Gebruik daarvoor de technische veldnaam en een passende vergelijking, zoals exact gelijk aan of begint met.
Wil je formulierverzendingen tellen met een gebeurtenis zoals generate_lead? Filter dan op die gebeurtenis en gebruik een bijpassende statistiek, zoals eventCount. Wil je belangrijke gebeurtenissen rapporteren, controleer dan of de betreffende gebeurtenis ook zo is gemarkeerd in GA4.
Een meegestuurde parameter verschijnt niet automatisch als beschikbare dimensie in de Data API. Daarvoor moet je, waar van toepassing, een aangepaste definitie in GA4 registreren. Het bereik van die definitie moet passen bij de manier waarop je de waarde meet.
De metadata-methode laat zien welke velden voor een property beschikbaar zijn. Met checkCompatibility kun je controleren of gekozen dimensies en statistieken samen bruikbaar zijn. Dat is nuttig bij rapporten met aangepaste velden.
Voor een website op maat kun je zo relevante interacties definiëren, bijvoorbeeld het afronden van een configurator. Leg daarbij vooraf vast wat een gebeurtenis betekent, zodat ontwikkelaars en marketeers dezelfde cijfers interpreteren.
Een verschil betekent niet direct dat de Google GA API verkeerd werkt. Vaak vergelijk je twee rapporten die net anders zijn ingesteld. Controleer eerst de meetdefinities en pas daarna de techniek.
(other).Controleer ook de metadata van het antwoord. Die kan aangeven of bijvoorbeeld drempelwaarden, sampling of beperkingen door veel unieke waarden een rol spelen. De API omzeilt zulke rapportagebeperkingen niet.
Eén persoon kan op meerdere dagen terugkomen. Tel je dagelijkse gebruikersaantallen bij elkaar op, dan tel je die persoon mogelijk vaker mee. Dat totaal hoeft daarom niet overeen te komen met het gebruikersaantal over de volledige periode.
Vraag voor een periodetotaal een afzonderlijk rapport op zonder datumdimensie. Hetzelfde aandachtspunt geldt wanneer je gebruikers verdeelt over pagina’s of andere categorieën waarin dezelfde gebruiker meermaals voorkomt.
GA4-omzet hangt af van de gebeurtenissen en waarden die je verstuurt. Ontbrekende aankopen, dubbele transacties, onjuist verwerkte terugbetalingen of een verkeerde valuta kunnen verschillen veroorzaken.
Bij een webshop op maat verdienen transactie-ID’s en de aankoopmeting daarom extra aandacht. Gebruik je ordersysteem als referentie voor daadwerkelijk geregistreerde bestellingen, en Analytics voor inzicht in gedrag en marketingprestaties.
De Google GA API kent gebruikslimieten. Daarbij telt niet alleen hoeveel verzoeken je verstuurt, maar ook hoe zwaar die verzoeken zijn. Veel rijen, uitgebreide filters en grote perioden kunnen meer capaciteit vragen.
Met returnPropertyQuota kun je quotagegevens bij een rapportantwoord opvragen. Stem je planning af op het beschikbare budget en voorkom dat meerdere dashboards onnodig hetzelfde rapport ophalen.
| Fout of signaal | Waarschijnlijke oorzaak | Wat controleer je? |
|---|---|---|
| 401 of UNAUTHENTICATED | Ontbrekende of ongeldige authenticatie. | Credentials, tokens en de identiteit waarmee de applicatie draait. |
| 403 of PERMISSION_DENIED | Onvoldoende toegang of een niet-ingeschakelde API. | GA4-propertyrechten, het Cloud-project en de API-activering. |
| 400 of INVALID_ARGUMENT | Ongeldige velden, datums, filters of combinaties. | Veldnamen, metadata en compatibiliteit. |
| 429 of RESOURCE_EXHAUSTED | Een quota- of capaciteitslimiet is bereikt. | Het betreffende quotum en de frequentie van je verzoeken. |
| Geen rijen | Geen passende gegevens of een te streng filter. | De property, periode, metingen en filters. |
Bij tijdelijke fouten kun je opnieuw proberen met steeds langere wachttijden. Blijf bij een uitgeput quotum niet eindeloos verzoeken herhalen: sommige limieten herstellen pas na hun eigen tijdvenster. Een fout in een veldnaam los je evenmin op door te wachten.
Voor een dagelijks marketingdashboard hoeft niet iedere bezoeker van het dashboard een nieuw API-verzoek te veroorzaken. Haal gegevens centraal op, bewaar ze en laat het dashboard die opgeslagen versie gebruiken.
Ververs recente dagen opnieuw omdat gegevens nog kunnen veranderen. Hoe ver je terugkijkt, hangt af van je rapportagedoel en de verwerking van de gebruikte statistieken. Noteer ook wanneer een rapport voor het laatst succesvol is bijgewerkt.
Een API-koppeling geeft geen extra toestemming om persoonsgegevens te verzamelen. Stuur geen e-mailadressen, telefoonnummers of andere verboden persoonsgegevens naar Google Analytics. Let ook op URL’s en formulierparameters waarin zulke gegevens kunnen belanden.
De koppeling vervangt evenmin een passende toestemmingsinrichting. Wat je mag meten en opslaan, hangt af van je implementatie en de geldende privacyregels. Consent Mode is een technische functie, geen automatische garantie dat alles juridisch goed geregeld is.
Een publieke website hoort dus niet rechtstreeks met een geheime serviceaccountsleutel de Google GA API aan te roepen. Laat een beveiligde server de gegevens ophalen en bepaal daar welke informatie bezoekers mogen zien.
De standaardrapportage is geschikt voor terugkerende analyses van website- en marketingprestaties. Voor een actueel activiteitenoverzicht bestaat runRealtimeReport. Die methode heeft een eigen, beperktere set velden en vervangt geen historisch rapport.
Wil je complete routes op gebeurtenisniveau onderzoeken of Analytics-gegevens uitgebreid combineren met bedrijfsdata? Dan past BigQuery vaak beter. Daar werk je met geëxporteerde gebeurtenisgegevens en eigen SQL-query’s.
Verwacht niet dat BigQuery automatisch exact dezelfde uitkomsten geeft als ieder GA4-rapport. Rapportagefuncties, modellering en de manier waarop je gegevens groepeert kunnen verschillen. Bovendien vraagt een datawarehouse om beheer en kunnen opslag en query’s kosten veroorzaken.
Voor een standaard marketingoverzicht kan een bestaande connector in Looker Studio voldoende zijn. Een eigen API-koppeling is vooral logisch wanneer je specifieke filters, eigen bedrijfslogica of integratie met een interne toepassing nodig hebt. Meer maatwerk is niet vanzelf een beter rapport.
Een goede Google GA API-koppeling begint met een meetvraag en eindigt met een controleerbaar antwoord. Leg vast welke property je gebruikt, hoe je statistieken definieert en wanneer gegevens worden vernieuwd. Pas daarna heeft verdere automatisering echt waarde.
Bij IWolf bekijken we websitebouw, meetinrichting en SEO in samenhang. Wil je een bestaande website beter meetbaar maken, dan kun je een voorstel aanvragen met je gewenste rapporten en huidige systemen. Gaat het om een nieuwe website, dan kun je bij een websiteofferte aanvragen direct aangeven welke aanvragen, verkopen of andere resultaten je wilt volgen.
Begin klein: één betrouwbare gegevensbron, duidelijke definities en een rapport dat een echte vraag beantwoordt. Wil je bespreken welke aanpak bij jouw bedrijf past? Neem contact op met IWolf voor een gerichte afstemming over je website, SEO en meetinrichting.
Voor Google Analytics 4 heb je de Google Analytics Data API nodig. Die API is ontwikkeld om rapportgegevens uit GA4 op te halen, zoals sessies, gebruikers, verkeersbronnen en gebeurtenissen. De oude Universal Analytics-API werkt niet meer voor GA4-data, dus het is belangrijk om de juiste API te gebruiken.
Met de google ga api kun je veel soorten rapportdata uit Google Analytics 4 ophalen. Denk aan dimensies zoals bron/medium, pagina’s, land of apparaat, en statistieken zoals sessies, gebruikers, event-aantallen en omzet. Daarmee kun je automatische dashboards, exports en maatwerkrapporten bouwen zonder handmatig data te exporteren.
Verschillen kunnen ontstaan door filters, attributiemodellen, tijdzones of het niveau waarop je data opvraagt. Ook kan het zijn dat je in de API andere dimensies of statistieken combineert dan in standaardrapporten, waardoor de uitkomst anders lijkt. Controleer daarom altijd of je dezelfde datumrange, property-instellingen en definities gebruikt als in je dashboard.
Je stelt de API meestal in via een serviceaccount of OAuth, afhankelijk van de toepassing. Een serviceaccount is handig voor automatische server-to-server koppelingen, terwijl OAuth beter past als je data namens een ingelogde gebruiker ophaalt. Geef alleen toegang tot de juiste GA4-property en bewaar inloggegevens veilig, zodat je de data beheerst en beschermd ophaalt.
Laatst bijgewerkt op 21 November 2026
