Hoe GMBapi.com te integreren met BigQuery
De integratie van lokale GMBapi.com-data met BigQuery opent krachtige nieuwe mogelijkheden, zoals geavanceerde data-analyse, aangepaste rapportage en naadloze integratie met uw bestaande tools. Deze gids leidt u stap voor stap door het opzetten van de BigQuery-integratie en het maximaliseren van het potentieel ervan voor uw bedrijf.
Wat u krijgt met onze BigQuery-integratie
Met deze integratie kunt u:
Toegang krijgen tot georganiseerde en gestructureerde
BigQuery-tabellen (geen ruwe data-dumps).
De tabellen worden dagelijks bijgewerkt met de meest recente gegevens van uw GBP's.
Genereer uw aangepaste Google
Bedrijfsprofielrapporten en inzichten.
Integreer onze bruikbare inzichten direct in uw eigen platform, software of website.
Gebruik de meegeleverde code om de visualisaties die op onze website te zien zijn, te repliceren op uw rapporten of op uw website!
Vereisten voor BigQuery- en GMBapi.com-integratie
Voordat je je BigQuery-integratie instelt, zorg je ervoor dat:
Je een actief GMBapi.com-account hebt met al je locaties gesynchroniseerd!
Je een actief factureringsaccount hebt gekoppeld aan je Google Cloud-project.
Je een serviceaccount hebt gemaakt met de volgende rollen:BigQuery Data Editor is noodzakelijk om een tabel aan te maken/bewerken binnen je GCPBigQuery Job User - Noodzakelijk om queries te plannen en uit te voeren
Deel het e-mailadres van het serviceaccount en de naam/namen van de accounts in app.gmbapi.com die toegang moeten krijgen.
Zodra de toegang tot de tabellen is gedeeld, kun je queries plannen met behulp van het gemaakte serviceaccount in je eigen BigQuery-project.
Stapsgewijze handleiding voor het instellen van BigQuery-integratie
*Als je al een Google Cloud Platform-account met facturering hebt ingesteld, kun je overslaan naar Stap 3
Stap 1: Maak een Google Cloud-project
Navigeer naar Google Cloud Platform.
Maak een nieuw project of selecteer een bestaand project.
Stap 2: Stel de factuurgegevens in
Ga naar de Google Cloud Console .
Selecteer in het menu aan de linkerkant “Facturering ” → klik vervolgens op “Factureringsaccounts beheren ”.
Kies de juiste organisatie (indien van toepassing) en klik op “Account aanmaken ”.
Geef een naam op voor uw factureringsaccount, selecteer uw land en koppel het aan de juiste organisatie.
Voeg een geldige betaalmethode toe en dien in om facturering in te schakelen.
Stap 2.1. Koppel uw factureringsaccount aan het project
Selecteer in de Cloud Console het project dat u wilt koppelen.
Navigeer naar de sectie “Facturering ”.
Selecteer, indien gevraagd, het factureringsaccount dat aan dit project moet worden gekoppeld.
Om later van factureringsaccount te wisselen, klikt u op “Factureringsaccounts beheren ” en kies de juiste optie.
⚠️ Opmerking: Zonder facturering ingeschakeld, worden geplande zoekopdrachten en andere BigQuery-bewerkingen niet uitgevoerd.
Stap 3: Een serviceaccount aanmaken en configureren
Ga in uw Google Cloud-project naar IAM & Beheer > Serviceaccounts .
Klik op Serviceaccount maken .
Geef uw serviceaccount een naam (bijv.
“BigQuery-integratie ").Wijs de volgende rollen toe om ervoor te zorgen dat het serviceaccount toegang heeft tot het plannen van query's en het maken van tabellen binnen de GCP: BigQuery-gegevenseditor BigQuery-taakgebruiker
Voltooi het maken van het serviceaccount en kopieer het gegenereerde e-mailadres.
Stap 4: Deel het e-mailadres van het serviceaccount
Deel het e-mailadres van het serviceaccount met ons ondersteuningsteam of via je integratiebeheerportaal.
Bevestig bovendien het GMBapi.com-account (GBP-locatiegroep) waartoe het serviceaccount toegang moet krijgen.
Gegevens worden per GBP-account opgeslagen en expliciete toegang is vereist voor elk account.
Opmerking: Als je in de toekomst toegang nodig hebt tot extra GBP-accounts, herhaal je gewoon stap 3 en verder voor elk nieuw account.
Stap 5: BigQuery instellen
Navigeer naar BigQuery binnen je Google Cloud Console.
Maak een nieuwe dataset aan of selecteer een bestaande.
Belangrijk Stel de datasetregio in op europe-west4 (Nederland).
Dit is vereist voor het overdragen van gegevens met behulp van een geplande query; de bron- en doelregio's moeten overeenkomen. Aangezien GMBapi.com gegevens opslaat in Nederland, moet je dataset zich ook in die regio bevinden om de overdracht mogelijk te maken.
Opmerking: Indien nodig kun je je gegevens later repliceren of migreren naar een andere regio. Leer meer 👉 BigQuery Gegevensreplicatie
Stap 6: Toegang krijgen tot en gebruikmaken van je gegevens
Zodra toegang is verleend, zijn er twee belangrijke manieren om met je gegevens te werken:
Geplande Query's (Aanbevolen)
Gebruik geplande query's in je BigQuery-project om de georganiseerde gegevens van GMBapi.com naar je eigen dataset te kopiëren. Dit garandeert langetermijntoegang en eigendom van de gegevens.
Gebruik de serviceaccountgegevens bij het instellen van geplande query's.
Directe toegang via BigQuery API
Als alternatief kun je de serviceaccountgegevens gebruiken om de gegevens rechtstreeks via de BigQuery API binnen je code te benaderen.
✅ Aanbeveling: Voor betere controle, draagbaarheid en toekomstbestendigheid raden we aan om een kopie van de tabellen te maken binnen je eigen GCP-project, hetzij via geplande query's, hetzij programmatisch met behulp van de BigQuery API.
Ons team zal direct bruikbare SQL-sjablonen en visuele codefragmenten leveren om je snel op weg te helpen.
Voorbeeldgebruiksscenario's voor BigQuery-integratie
Aangepaste rapporten
Genereer op maat gemaakte rapporten specifiek voor je zakelijke behoeften, waarbij je dieper ingaat op de prestatiegegevens van lokale SEO.
Platformintegratie
Integreer onze inzichten naadloos in je CRM, website-dashboard of elk analyseplatform dat je bedrijf gebruikt.
Geavanceerde analyse
Gebruik de krachtige analysemogelijkheden van BigQuery om sneller dan ooit trends, kansen en bruikbare inzichten te ontdekken.
Hulp krijgen
Als je ergens in het proces vastloopt, staat ons team voor je klaar. Aarzel niet om contact op te nemen als je niet zeker weet hoe je machtigingen moet instellen, serviceaccounts moet aanmaken of queries moet plannen. We zijn toegewijd aan het soepel en succesvol maken van je integratieproces.
Vraag toegang aan tot een locatiegroep en start een gratis proefperiode. Vervolgens:
Neem contact op met ons supportteam.
Stel je BigQuery-project in.
Zorg ervoor dat je factureringsaccount actief is.
Maak een serviceaccount aan met de juiste rollen.
Deel het e-mailadres van het serviceaccount en de relevante app.gmbapi.com accountnamen.
Begin met het plannen van queries om gestructureerde datatabellen op te halen.
Voor gedetailleerde hulp kun je onze uitgebreide documentatie raadplegen of rechtstreeks contact opnemen met ons supportteam om je BigQuery-integratie-ervaring te stroomlijnen.
Omarm het volledige potentieel van je lokale SEO-data met onze robuuste BigQuery-integratie, waardoor slimmere, data-gestuurde beslissingen eenvoudiger dan ooit worden.
Veelgestelde vragen over GMBapi.com en BigQuery-integratie
Veelgestelde vragen
Om de integratie in te stellen, heb je een actief GMBapi.com-account nodig met gesynchroniseerde locaties, een Google Cloud Project met facturering ingeschakeld, en een serviceaccount met de juiste BigQuery-rollen. Zodra dit is geregeld, kan ons team toegang verlenen tot gestructureerde BigQuery-tabellen die dagelijks worden bijgewerkt met je Google Bedrijfsprofiel-data.
Het serviceaccount moet de rollen BigQuery Data Editor en BigQuery Job User hebben. De Data Editor-rol stelt het account in staat tabellen te maken en te bewerken binnen je project, terwijl de Job User-rol het mogelijk maakt om queries te plannen en uit te voeren. Zonder deze rollen functioneren je integratie en dataoverdrachten niet correct.
Je dataset moet zich in europe-west4 bevinden omdat GMBapi.com zijn data in Nederland opslaat. Google vereist dat de bron- en doelregio's overeenkomen om dataoverdrachten te laten werken. Als de regio's niet zijn uitgelijnd, mislukken je geplande queries en datapijplijnen. Indien nodig kun je de data later repliceren of migreren naar een andere regio, maar de initiële dataset moet in europe-west4 zijn.
De BigQuery-tabellen worden dagelijks bijgewerkt met de meest recente data van je Google Bedrijfsprofielen. Dit zorgt ervoor dat je analyses, dashboards en rapporten altijd de nieuwste lokale SEO-prestatiestatistieken weergeven, zonder dat handmatige updates nodig zijn.
Je hebt op twee manieren toegang tot je data. De aanbevolen methode is het gebruik van geplande queries, die de gestructureerde tabellen van GMBapi.com kopiëren naar je eigen BigQuery-project, zodat je de lange termijn controle en eigendom behoudt. Als alternatief kun je de BigQuery API gebruiken om de data direct op te vragen met je serviceaccountgegevens. De meeste bedrijven kiezen voor geplande queries, omdat deze meer flexibiliteit en portabiliteit bieden.
Ja, de integratie is ontworpen om naadloos samen te werken met uw bestaande tools. Zodra uw gegevens beschikbaar zijn in BigQuery, kunt u deze rechtstreeks koppelen aan uw dashboards, CRM-systemen, websites of analyseplatforms. Veel bedrijven gebruiken deze functionaliteit om aangepaste dashboards te bouwen of inzichten te integreren in hun bestaande workflows.
Als u problemen ondervindt, of het nu gaat om het instellen van het serviceaccount, het inschakelen van facturering of het plannen van query's, kunt u contact opnemen met het ondersteuningsteam van GMBapi.com. Ons team is beschikbaar om u door het proces te leiden en ervoor te zorgen dat uw integratie van begin tot eind soepel verloopt.
