Observera: Översättningen av denna artikel är endast avsedd att underlätta för dig. Översättningen har skapats automatiskt med hjälp av en översättningsprogramvara och har eventuellt inte korrekturlästs. Den engelska versionen av denna artikel bör därför betraktas som den gällande versionen med den senaste informationen. Du kan komma åt den här.

Få tillgång till HubSpot-data i Google BigQuery (BETA)

Senast uppdaterad: 30 juni 2026

Tillgänglig med något av följande abonnemang, om inte annat anges:

Data Hub Enterprise

När du har kopplat Google BigQuery till ditt HubSpot-konto kan du göra sökningar efter HubSpot-data i BigQuery.

Den här artikeln innehåller information om schemat för varje tabell som synkroniseras till BigQuery, vilket du kan använda tillsammans med Googles dokumentation för att söka efter HubSpot-data i ditt BigQuery-konto.

Dataöversikt

Sökningar skapas med hjälp av SQL och kan användas för att hämta HubSpot-data såsom:

Objekt: standardobjekt och anpassade objekt, till exempel kontakter, företag och produkter.
Poster: enskilda poster, till exempel en enskild kontakt eller ett företag.
Associeringar: alla tillgängliga associeringstyper och post som för närvarande är associerade.
Händelser: händelsedata för både standardhändelser i HubSpot, till exempel öppnade e-postmeddelanden, och anpassade beteendehändelser.

Objektdata av olika typer slås samman i v1: alla poster för alla objekttyper slås samman till ett databasobjekt. När du gör en sökning måste du därför ange ett filter som “WHERE objectTypeId=’0-1’

Anpassade objekt tilldelas ett ID vid skapandet och identifieras som 2-unique_ID. Till exempel 2-12345.

Läs mer om HubSpots CRM-datamodell.

Synkroniserade tabellscheman

Avsnitten nedan innehåller detaljer om schemat för varje tabell som synkroniseras från ditt HubSpot-konto till BigQuery, baserat på dina konfigurerade synkroniseringsinställningar.

Schema för object_properties

Schemat nedan innehåller detaljer om den synkroniserade tabellen object_properties:

Kolumnnamn	Typ	Beskrivning
OBJECTTYPEID	STRING	Objekttypens ID (t.ex. 0-1 för kontakter).
OBJECTID	INT64	Postens ID (t.ex. 123752 som ett exempel på en kontaktpost).
NAMN	STRING	Namnet på egenskapen.
VÄRDE	JSON	Egenskapens värde
UPDATEDAT	TIDSTEMPEL	Datum och tidpunkt då posten senast uppdaterades i HubSpot.
INGESTEDAT	TIDSTEMPEL	Datum och tidpunkt då posten senast importerades till BigQuery.

Schema för object_with_object_properties

Schemat nedan innehåller detaljer om den synkroniserade tabellen object_with_object_properties:

Kolumnnamn	Typ	Beskrivning
OBJECTTYPEID	STRING	Objekttypens ID (t.ex. 0–1 för kontakter).
OBJECTID	INT64	Postens ID (t.ex. 123752 som ett exempel på en kontaktpost).
EGENSKAPER	JSON	Postens egenskapsvärden
UPDATEDAT	TIMESTAMP	Datum och tidpunkt då posten senast uppdaterades i HubSpot.
INGESTEDAT	TIDSTEMPEL	Datum och tidpunkt då posten senast importerades till BigQuery.

schemat associations

Schemat nedan innehåller detaljer om den synkroniserade tabellen associations:

Kolumnnamn	Typ	Beskrivning
COMBINEDASSOCIATIONTYPEID	STRING	Den unika identifieraren för associationsdefinitionen.
FROMOBJECTID	INT64	Källobjektets ID.
TOOBJECTID	INT64	Målobjektets ID.
INGESTEDAT	TIMESTAMP	Datum och tidpunkt då posten senast importerades av BigQuery.

schemat association_definitions

Schemat nedan innehåller detaljer om den synkroniserade tabellen associations_definitions:

Kolumnnamn	Typ	Beskrivning
COMBINEDASSOCIATIONTYPEID	STRING	Den unika identifieraren för den specifika associeringsdefinitionen.
ASSOCIATIONCATEGORY	STRING	Associeringstypens ursprung. Möjliga värden är: HUBSPOT_DEFINED, USER_DEFINED eller INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	STRING	En unik identifierare för en associeringsdefinition inom dess ASSOCIATIONCATEGORY. Inga två definitioner i samma kategori kommer att dela detta ID.
FROMOBJECTTYPEID	STRING	Objekttyp-ID för associationens källobjekt.
FROMOBJECTTYPE	STRING	Namnet på källobjekttypen för associeringen.
TOOBJECTTYPEID	STRING	Objekttyp-ID för associationens målobjekt.
TOOBJECTTYPE	STRING	Namnet på associationens målobjekttyp.
NAME	STRING	Det definierade namnet på associationsdefinitionen.
LABEL	STRING	En beskrivande etikett för associationsdefinitionen.
ÄR HUVUDASSOCIATIONSDEFINITION	BOOLEAN	Anger om detta är den primära associeringstypen (true), vilket är den som HubSpot visar på associerade poster.
INGESTEDAT	TIDSTEMPEL	Datum och tidpunkt då posten senast importerades av BigQuery.

Händelser

Händelser omfattar standardhändelser i HubSpot och anpassade beteendehändelser. Varje händelse har sitt eget databasobjekt, benämnt events_eventname.

Namn
EVENTS_AD_INTERACTION	Detaljer om en annons och kontakter som interagerade med den genom att klicka på annonsen eller skicka in ett formulär efter att ha interagerat med den.
EVENTS_AD_METRICS_IMPORTED_V0	Information om en annons och dess prestationsmått.
EVENTS_CALL_MENTIONED_KEYWORD	Detaljer om sökord som nämnts av deltagare i samtal.
EVENTS_CALLED_LINK_IN_EMAIL_V2	Länkar som kontakter har klickat på i marknadsföringsmejl.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Länkar som kontakter har klickat på i e-postmeddelanden i Conversations-inkorgen.
EVENTS_COOKIE_BANNER_CLICKED	Kontakter som har klickat på cookies.
EVENTS_COOKIE_BANNER_VIEWED	Kontakter som har visat information om cookies.
EVENTS_DOCUMENT_SHARED_V2	Försäljningsdokument som delats med kontakter via en extern länk.
EVENTS_DOCUMENT_VIEWED_V2	Försäljningsdokument och kontakter som har visat dem genom att öppna den externa länken.
EVENTS_DOCUMENT_COMPLETED_V2	Försäljningsdokument och kontakter som har avslutat dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-postmeddelanden som skickats till HubSpots e-postservrar för att skickas.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-postmeddelanden som har levererats framgångsrikt till mottagarna via HubSpots e-postservrar.
EVENTS_MTA_BOUNCED_EMAIL_V2	Försök att leverera e-postmeddelanden som avvisats av mottagarens e-postserver.
EVENTS_OPENED_EMAIL_V2	E-postmeddelanden som öppnats av kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-postmeddelanden som har markerats som skräppost av mottagarna.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Ändringar av e-postprenumerationer gjorda av mottagare.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Öppnade e-postmeddelanden i inkorgen av kontakter.
EVENTS_MB_MEDIA_PLAYED	Videouppspelningsaktivitet hos kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakten har bokat ett möte via sekvensen.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakten har anmält sig till sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvensen är avslutad.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten har svarat på e-postmeddelandet (eller det inkommande e-postmeddelandet som avregistrerade sekvensen) som skickades via sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakten har avregistrerats från sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Användaren har manuellt avregistrerat kontakten.
EVENTS_V2_KONTAKT_AVREGISTRERAD_FRÅN_SEKVENS_E-POST	Kontakten har avslutat prenumerationen och avregistrerats från sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvensmejlet studsade tillbaka.
EVENTS_V2_SEQUENCE_ERRORED	Fel i sekvensen som ledde till avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenssteg utfört.
EVENTS_VISITED_PAGE	Besök på webbplatsen av kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationshändelser (Timeline V3 API)

Du kan identifiera händelser genom att kombinera deras händelsetyp-ID och ID. Vilka kolumner som returneras beror på händelsen, med en kolumn för varje händelseegenskap. Alla händelser returnerar följande kolumner:

Kolumnnamn	Typ	Beskrivning
`EVENTTYPEID`	STRING	Händelsetypens ID, liknande OBJECTTYPEID Du kan söka efter alla händelsetyp-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
`ID`	STRING	Detta är unikt för varje händelsetyp. Det finns inte två poster med samma ID inom en viss händelsetyp.
`OBJECTTYPEID`	STRING	Typen av objekt som fullföljde händelsen. Till exempel skulle ett klick på en länk i ett e-postmeddelande visa`0-1` i denna kolumn, vilket representerar kontaktobjektet.
`OBJECTID`	INT64	ID för den post som utlöste händelsen.
`OCCURREDAT`	TIMESTAMP	När händelsen inträffade.
`OCCURREDATDATEINT`	INT64	Ett tal som anger när händelsen inträffade. Innehåller samma data som kolumnen `OCCURREDAT`, men formaterad som ett tal och används som en del av tabellens klusternyckel. I de flesta fall kan du använda tidsstämpeln `OCCURREDAT` istället för detta tal.
`OCCUREDATDATEINT`	Tal	Ett tal som anger när händelsen inträffade. Innehåller samma data som kolumnen `OCCURREDAT`, men formaterad som ett tal och används som en del av tabellens klusternyckel. I de flesta fall kan du använda tidsstämpeln `OCCURREDAT` istället för detta tal.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades till BigQuery. Läs mer om kolumndatatyper.
`PROPERTY_*`	Varchar	Enskilda kolumner som innehåller händelseegenskaperna.

Hjälpte artikeln?

Detta formulär används endast för dokumentationsfeedback. Få reda på hur du får hjälp med HubSpot.

TestversionFå tillgång till HubSpot-data i Google BigQuery (BETA)