Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak.

Toegang tot HubSpot-gegevens in Google BigQuery (BETA)

Laatst bijgewerkt: 1 juni 2026

Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:

Data Hub Enterprise

Nadat u Google BigQuery aan uw HubSpot-account hebt gekoppeld, kunt u in BigQuery op HubSpot-gegevens zoeken.

Dit artikel bevat informatie over het schema voor elke tabel die met BigQuery is gesynchroniseerd. Je kunt deze informatie samen met de documentatie van Google gebruiken om HubSpot-gegevens op te vragen in je BigQuery-account.

Overzicht van gegevens

Zoekopdrachten worden opgesteld met behulp van SQL en kunnen worden gebruikt om HubSpot-gegevens op te halen, zoals:

Objecten: standaard- en aangepaste objecten, zoals contactpersonen, bedrijven en producten.
Records: individuele records, zoals een individueel contact of bedrijf.
Koppelingen: alle beschikbare koppelingstypen en momenteel gekoppelde records.
Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals het openen van e-mails, als aangepaste gedragsgebeurtenissen.

Objectgegevens van verschillende typen worden gecombineerd voor v1: alle records voor alle objecttypen worden samengevoegd tot één databaseobject. Bij het opvragen moet u daarom een filter specificeren zoals “WHERE objectTypeId=’0-1’

Aangepaste objecten krijgen bij het aanmaken een ID toegewezen en worden geïdentificeerd als 2-unique_ID. Bijvoorbeeld 2-12345.

Meer informatie over het CRM-gegevensmodel van HubSpot.

Gesynchroniseerde tabelschema's

De onderstaande secties geven details over het schema voor elke tabel die vanuit uw HubSpot-account naar BigQuery wordt gesynchroniseerd, op basis van uw geconfigureerde synchronisatie-instellingen.

object_properties-schema

Het onderstaande schema geeft details over de gesynchroniseerde object_properties-tabel:

Kolomnaam	Type	Beschrijving
OBJECTTYPEID	TEKST	De ID van het objecttype (bijv. 0-1 voor contactpersonen).
OBJECTID	INT64	De ID van het record (bijv. 123752 als voorbeeld van een contactrecord).
NAAM	STRING	De naam van de eigenschap.
VALUE	JSON	De waarde van de eigenschap
UPDATEDAT	TIMESTAMP	De datum en tijd waarop het record voor het laatst is bijgewerkt in HubSpot.
INGESTEDAT	TIMESTAMP	De datum en tijd waarop het record voor het laatst door BigQuery is ingelezen.

object_with_object_properties-schema

Het onderstaande schema bevat details over de gesynchroniseerde tabel object_with_object_properties:

Kolomnaam	Type	Beschrijving
OBJECTTYPEID	STRING	De ID van het objecttype (bijv. 0-1 voor contactpersonen).
OBJECTID	INT64	De ID van het record (bijv. 123752 als voorbeeld van een contactrecord).
PROPERTIES	JSON	De eigenschapswaarden van het record
UPDATEDAT	TIMESTAMP	De datum en tijd waarop het record voor het laatst is bijgewerkt in HubSpot.
INGESTEDAT	TIMESTAMP	De datum en tijd waarop het record voor het laatst door BigQuery is ingelezen.

associations_x_to_y-schema

Het onderstaande schema geeft details weer van de gesynchroniseerde associations_x_to_y-tabel:

Kolomnaam	Type	Beschrijving
COMBINEDASSOCIATIONTYPEID	TEKST	De unieke identificatiecode voor de specifieke associatiedefinitie.
ASSOCIATIONCATEGORY	TEKST	De oorsprong van het associatietype. Mogelijke waarden zijn onder meer: HUBSPOT_DEFINED, USER_DEFINED of INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	TEKST	Een unieke identificatiecode voor een associatiedefinitie binnen de bijbehorende ASSOCIATIONCATEGORY. Geen twee definities in dezelfde categorie hebben dezelfde ID.
FROMOBJECTTYPEID	STRING	De objecttype-ID van het bronobject van de associatie.
FROMOBJECTTYPE	STRING	De naam van het bronobjecttype van de associatie.
TOOBJECTTYPEID	STRING	De objecttype-ID van het doelobject van de associatie.
TOOBJECTTYPE	STRING	De naam van het doelobjecttype van de associatie.
NAME	STRING	De gedefinieerde naam van de associatiedefinitie.
LABEL	TEKST	Een beschrijvend label voor de associatiedefinitie.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Geeft aan of dit het primaire associatietype is (true), dat is het type dat HubSpot weergeeft bij geassocieerde records.
[FROMOBJECTTYPE_OBJECTID]	INT64	De object-ID van het bronrecord. (bijv. CONTACT_OBJECTID voor een ASSOCIATIONS_CONTACTS_TO_DEALS-weergave).
[TOOBJECTTYPE_OBJECTID]	INT64	De object-ID van het doelrecord. (bijv. DEAL_OBJECTID voor een ASSOCIATIONS_CONTACTS_TO_DEALS-weergave).
INGESTEDAT	TIMESTAMP	De datum en tijd waarop het record voor het laatst door BigQuery is ingelezen.

associations-schema

Het onderstaande schema geeft details weer van de gesynchroniseerde tabel associations:

Kolomnaam	Type	Beschrijving
COMBINEDASSOCIATIONTYPEID	STRING	De unieke identificatiecode van de associatiedefinitie.
FROMOBJECTID	INT64	De ID van het bronobject.
TOOBJECTID	INT64	De ID van het doelobject.
INGESTEDAT	TIMESTAMP	De datum en tijd waarop het record voor het laatst door BigQuery is ingelezen.

schema association_definitions

Het onderstaande schema geeft details weer van de gesynchroniseerde tabel associations_definitions:

Kolomnaam	Type	Beschrijving
COMBINEDASSOCIATIONTYPEID	TEKST	De unieke identificatiecode voor de specifieke associatiedefinitie.
ASSOCIATIONCATEGORY	TEKST	De oorsprong van het associatietype. Mogelijke waarden zijn onder meer: HUBSPOT_DEFINED, USER_DEFINED of INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	TEKST	Een unieke identificatiecode voor een associatiedefinitie binnen de bijbehorende ASSOCIATIONCATEGORY. Geen twee definities in dezelfde categorie hebben dezelfde ID.
FROMOBJECTTYPEID	STRING	De objecttype-ID van het bronobject van de associatie.
FROMOBJECTTYPE	STRING	De naam van het bronobjecttype van de associatie.
TOOBJECTTYPEID	STRING	De objecttype-ID van het doelobject van de associatie.
TOOBJECTTYPE	STRING	De naam van het doelobjecttype van de associatie.
NAME	STRING	De gedefinieerde naam van de associatiedefinitie.
LABEL	TEKST	Een beschrijvend label voor de associatiedefinitie.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Geeft aan of dit het primaire associatietype is (true), dat is het type dat HubSpot weergeeft bij geassocieerde records.
INGESTEDAT	TIMESTAMP	De datum en tijd waarop het record voor het laatst door BigQuery is ingelezen.

Gebeurtenissen

Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen. Elke gebeurtenis heeft zijn eigen databaseobject, aangeduid als events_eventname.

Naam
EVENTS_AD_INTERACTION	Details van een advertentie en contacten die ermee hebben geïnterageerd door op de advertentie te klikken of een formulier in te vullen na interactie.
EVENTS_AD_METRICS_IMPORTED_V0	Details van een advertentie en de prestatiestatistieken ervan.
EVENTS_CALL_MENTIONED_KEYWORD	Details van zoekwoorden die door deelnemers aan gesprekken zijn genoemd.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Links waarop contactpersonen in marketing-e-mails hebben geklikt.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Links waarop contactpersonen hebben geklikt in e-mails in de Inbox van Conversations.
EVENTS_COOKIE_BANNER_CLICKED	Contactpersonen die op cookies hebben geklikt.
EVENTS_COOKIE_BANNER_VIEWED	Contactpersonen die cookies hebben bekeken.
EVENTS_DOCUMENT_SHARED_V2	Verkoopdocumenten die via een externe link met contactpersonen zijn gedeeld.
EVENTS_DOCUMENT_VIEWED_V2	Verkoopdocumenten en contactpersonen die deze hebben bekeken door de externe link te openen.
EVENTS_DOCUMENT_COMPLETED_V2	Verkoopdocumenten en contactpersonen die deze hebben afgesloten.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-mails die zijn verzonden naar de HubSpot-e-mailservers om te worden verzonden.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-mails die met succes door de e-mailservers van HubSpot bij de ontvangers zijn afgeleverd.
EVENTS_MTA_BOUNCED_EMAIL_V2	Pogingen om e-mails te bezorgen die zijn geweigerd door de e-mailserver van de ontvanger.
EVENTS_OPENED_EMAIL_V2	E-mails geopend door contactpersonen.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-mails die door ontvangers als spam zijn gemarkeerd.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Wijzigingen in e-mailabonnementen door ontvangers.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Gesprekken E-mails in de Inbox geopend door contactpersonen.
EVENTS_MB_MEDIA_PLAYED	Activiteit van videoweergave door contactpersonen.
EVENTS_V2_CONTACT_VERBOEKTE_AFSPRAAK_VIA_SEQUENCE	Contactpersoon heeft een vergadering geboekt via een reeks.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Contact heeft zich aangemeld via de reeks.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sequentie is voltooid.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Contact heeft gereageerd op e-mail (of inkomende e-mail waarmee de inschrijving voor de reeks is geannuleerd) die via de reeks is verzonden.
EVENTS_V2_CONTACT_AFGEMELD_VAN_SEQUENTIE	Contact heeft zich afgemeld voor de reeks.
EVENTS_V2_CONTACT_HANDMATIG_AFGEMELD_VAN_SEQUENTIE	De gebruiker heeft de contactpersoon handmatig uitgeschreven.
EVENTS_V2_CONTACT_AFGEMELD_SEQUENTIE_E-MAIL	Contact heeft zich afgemeld, waardoor de reeks is geannuleerd.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	De e-mail van de reeks is teruggestuurd.
EVENTS_V2_SEQUENCE_ERRORED	Er is een fout opgetreden in de reeks, waardoor de afmelding is geactiveerd.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Stap in de reeks uitgevoerd.
EVENTS_VISITED_PAGE	Bezoeken aan webpagina's door contactpersonen.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integratie-events (Timeline V3 API)

U kunt gebeurtenissen identificeren door hun gebeurtenistype-ID en ID te combineren. De kolommen die worden geretourneerd, zijn afhankelijk van de gebeurtenis, met één kolom voor elke gebeurteniseigenschap. Alle gebeurtenissen retourneren de volgende kolommen:

Kolomnaam	Type	Beschrijving
`EVENTTYPEID`	TEKST	De ID van het gebeurtenistype, vergelijkbaar met OBJECTTYPEID U kunt alle gebeurtenistype-ID's in uw account opvragen met behulp van de weergave object_and_event_type_definitions.
`ID`	STRING	Dit is uniek per gebeurtenistype. Geen twee records hebben dezelfde ID binnen een bepaald gebeurtenistype.
`OBJECTTYPEID`	STRING	Het type object dat de gebeurtenis heeft voltooid. Bijvoorbeeld: bij een klik op een e-maillink wordt in deze kolom`0-1` weergegeven, wat staat voor het contactenobject.
`OBJECTID`	INT64	Het ID van het record dat de gebeurtenis heeft voltooid.
`OCCURREDAT`	TIMESTAMP	Wanneer de gebeurtenis plaatsvond.
`OCCURREDATDATEINT`	INT64	Een getal dat aangeeft wanneer de gebeurtenis plaatsvond. Bevat dezelfde gegevens als de kolom `OCCURREDAT`, maar is opgemaakt als een getal en wordt gebruikt als onderdeel van de clustersleutel van de tabel. In de meeste gevallen kunt u de tijdstempel `OCCURREDAT` gebruiken in plaats van dit getal.
`OCCUREDATDATEINT`	Getal	Een getal dat aangeeft wanneer de gebeurtenis plaatsvond. Bevat dezelfde gegevens als de kolom `OCCURREDAT`, maar is opgemaakt als een getal en wordt gebruikt als onderdeel van de clustersleutel van de tabel. In de meeste gevallen kunt u de tijdstempel `OCCURREDAT` gebruiken in plaats van dit getal.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door BigQuery zijn ingelezen. Meer informatie over kolomgegevenstypen.
`PROPERTY_*`	Varchar	Afzonderlijke kolommen met de gebeurteniseigenschappen.

Was dit artikel nuttig?

Dit formulier wordt alleen gebruikt voor feedback op documentatie. Ontdek hoe je hulp krijgt met HubSpot.

BètaToegang tot HubSpot-gegevens in Google BigQuery (BETA)