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

HubSpot-gegevens openen in Google BigQuery (BETA)

Laatst bijgewerkt: 30 juni 2026

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

Data Hub Enterprise

Nadat je Google BigQuery aan je HubSpot-account hebt gekoppeld, kun je in BigQuery op HubSpot-gegevens zoeken.

Dit artikel bevat informatie over het schema van 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 de 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 de records die momenteel zijn gekoppeld.
Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals het openen van e-mails, als aangepaste gedragsgebeurtenissen.

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

Aangepaste objecten krijgen bij het aanmaken een ID toegewezen en worden aangeduid als 2-unique_ID. Bijvoorbeeld: 2-12345.

Meer informatie over het CRM-gegevensmodel van HubSpot.

Gesynchroniseerde tabelschema’s

In de onderstaande secties vindt u details over het schema van elke tabel die vanuit uw HubSpot-account naar BigQuery wordt gesynchroniseerd, op basis van uw geconfigureerde synchronisatie-instellingen.

object_properties-schema

Het onderstaande schema bevat details over de gesynchroniseerde tabel `object_properties`:

Kolomnaam	Type	Beschrijving
OBJECTTYPEID	TEKST	De ID van het objecttype (bijv. 0-1 voor contactpersonen).
OBJECTID	INT64	De ID van het record (bijvoorbeeld 123752 als voorbeeld van een contactrecord).
NAME	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	Het ID van het record (bijvoorbeeld 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-schema

Het onderstaande schema bevat details over de gesynchroniseerde tabel associations:

Kolomnaam	Type	Beschrijving
COMBINEDASSOCIATIONTYPEID	TEKST	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.

association_definitions-schema

Het onderstaande schema bevat details over de gesynchroniseerde tabel associations_definitions:

Kolomnaam	Type	Beschrijving
COMBINEDASSOCIATIONTYPEID	TEKST	De unieke identificatiecode voor de specifieke associatiedefinitie.
ASSOCIATIONCATEGORY	TEKST	De herkomst 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	TEKST	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 wil zeggen het type dat HubSpot weergeeft bij gekoppelde 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 een eigen databaseobject, met de naam events_eventname.

Naam
EVENTS_AD_INTERACTION	Details van een advertentie en contacten die er interactie mee hebben gehad door op de advertentie te klikken of een formulier in te vullen na interactie met de advertentie.
EVENTS_AD_METRICS_IMPORTED_V0	Gegevens over een advertentie en de prestatiestatistieken ervan.
EVENTS_CALL_MENTIONED_KEYWORD	Details van zoekwoorden die door deelnemers aan gesprekken zijn genoemd.
EVENTS_CALLED_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 Conversations-inbox.
EVENTS_COOKIE_BANNER_CLICKED	Contactpersonen die op cookies hebben geklikt.
EVENTS_COOKIE_BANNER_VIEWED	Contactpersonen die de cookie-informatie 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 e-mailservers van HubSpot om te worden verstuurd.
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 tot aflevering van e-mails die door de e-mailserver van de ontvanger zijn geweigerd.
EVENTS_OPENED_EMAIL_V2	E-mails die door contactpersonen zijn geopend.
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	Geregistreerde e-mails in de Inbox die door contactpersonen zijn geopend.
EVENTS_MB_MEDIA_PLAYED	Activiteit met betrekking tot het afspelen van video's door contactpersonen.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Contactpersoon heeft een afspraak geboekt via een reeks.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Contact heeft zich via de reeks aangemeld.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	De reeks is voltooid.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Contactpersoon heeft gereageerd op de 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	Contactpersoon heeft zich afgemeld voor de reeks.
EVENTS_V2_CONTACT_HANDMATIG_UIT_SEQUENTIE_AFGEMELD	De gebruiker heeft de contactpersoon handmatig uitgeschreven.
EVENTS_V2_CONTACT_AFGEMELD_SEQUENTIE_E-MAIL	Contact heeft zich afgemeld, waardoor de reeks is beëindigd.
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>	Integratiegebeurtenissen (Timeline V3 API)

U kunt gebeurtenissen identificeren door de ID van het gebeurtenistype te combineren met de ID van de gebeurtenis. Welke kolommen worden geretourneerd, hangt af van de gebeurtenis, met één kolom voor elke eigenschap van de gebeurtenis. 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 via de weergave object_and_event_type_definitions.
`ID`	STRING	Deze is uniek per gebeurtenistype. Binnen een bepaald gebeurtenistype zullen geen twee records dezelfde ID hebben.
`OBJECTTYPEID`	STRING	Het type object dat de gebeurtenis heeft voltooid. Bijvoorbeeld: bij een klik op een link in een e-mail 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 die de gebeurteniseigenschappen bevatten.

Was dit artikel nuttig?

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

BètaHubSpot-gegevens openen in Google BigQuery (BETA)