- Vidensbase
- Konto og opsætning
- Integrationer
- Få adgang til HubSpot-data i Google BigQuery (BETA)
I betaFå adgang til HubSpot-data i Google BigQuery (BETA)
Sidst opdateret: 1 juni 2026
Gælder for:
-
Data Hub Enterprise
Når du har forbundet Google BigQuery med din HubSpot-konto, kan du søge efter HubSpot-data i BigQuery.
Denne artikel indeholder oplysninger om skemaet for hver tabel, der synkroniseres med BigQuery, som du kan bruge sammen med Googles dokumentation til at søge efter HubSpot-data i din BigQuery-konto.
Dataoversigt
Forespørgsler opbygges ved hjælp af SQL og kan bruges til at hente HubSpot-data såsom:
- Objekter: standard- og brugerdefinerede objekter, såsom kontakter, virksomheder og produkter.
- Poster: individuelle poster, såsom en individuel kontakt eller virksomhed.
- Forbindelser: alle tilgængelige forbindelsestyper og aktuelt forbundne poster.
- Begivenheder: begivenhedsdata for både standard HubSpot-begivenheder, såsom åbning af e-mails, og brugerdefinerede adfærdsbegivenheder.
Objektdata af forskellige typer kombineres i v1: alle poster for alle objekttyper kombineres i ét databaseobjekt. Når du søger, skal du derfor angive et filter som f.eks “WHERE objectTypeId=’0-1’
Brugerdefinerede objekter tildeles et ID på oprettelsestidspunktet og identificeres som 2-unique_ID. For eksempel 2-12345.
Læs mere om HubSpots CRM-datamodel.
Synkroniserede tabelskemaer
Afsnittene nedenfor indeholder detaljer om skemaet for hver tabel, der synkroniseres fra din HubSpot-konto til BigQuery, baseret på dine konfigurerede synkroniseringsindstillinger.
object_properties-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede object_properties-tabel:
| Kolonnenavn | Type | Beskrivelse |
| OBJECTTYPEID | STRING | ID'et for objekttypen (f.eks. 0-1 for kontakter). |
| OBJECTID | INT64 | ID'et for posten (f.eks. 123752 som en eksempelkontaktpost). |
| NAME | STRING | Navnet på ejendommen. |
| VALUE | JSON | Egenskabens værdi |
| UPDATEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev opdateret i HubSpot. |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev indlæst af BigQuery. |
object_with_object_properties-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede object_with_object_properties-tabel:
| Kolonnenavn | Type | Beskrivelse |
| OBJECTTYPEID | STRING | ID'et for objekttypen (f.eks. 0-1 for kontakter). |
| OBJECTID | INT64 | ID'et for posten (f.eks. 123752 som en eksempelkontaktpost). |
| EGENSKABER | JSON | Postens egenskabsværdier |
| UPDATEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev opdateret i HubSpot. |
| INGESTEDAT | TIDSTEMPEL | Dato og klokkeslæt for, hvornår posten sidst blev indlæst af BigQuery. |
associations_x_to_y-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede associations_x_to_y_-tabel:
| Kolonnenavn | Type | Beskrivelse |
| COMBINEDASSOCIATIONTYPEID | STRING | Den unikke identifikator for den specifikke tilknytningsdefinition. |
| ASSOCIATIONCATEGORY | STRING | Oprindelsen til associationstypen. Mulige værdier omfatter: HUBSPOT_DEFINED, USER_DEFINED eller INTEGRATOR_DEFINED. |
| ASSOCIATIONTYPEID | STRING | En unik identifikator for en associeringsdefinition inden for dens ASSOCIATIONCATEGORY. Ingen to definitioner i samme kategori vil dele dette ID. |
| FROMOBJECTTYPEID | STRING | Objekttype-ID'et for associationens kildeobjekt. |
| FROMOBJECTTYPE | STRING | Navnet på foreningens kildeobjekttype. |
| TOOBJECTTYPEID | STRING | Objekttype-ID'et for foreningens målobjekt. |
| TOOBJECTTYPE | STRING | Navnet på foreningens destinationsobjekttype. |
| NAME | STRING | Det definerede navn på associeringsdefinitionen. |
| LABEL | STRING | En beskrivende etiket til associeringsdefinitionen. |
| ISMAINASSOCIATIONDEFINITION | BOOLEAN | Angiver, om dette er den primære associationstype (true), som er den, HubSpot viser på associerede poster. |
| [FROMOBJECTTYPE_OBJECTID] | INT64 | Objekt-ID'et for kildeposten. (f.eks. CONTACT_OBJECTID for en ASSOCIATIONS_CONTACTS_TO_DEALS-visning). |
| [TOOBJECTTYPE_OBJECTID] | INT64 | Objekt-ID'et for destinationsposten. (f.eks. DEAL_OBJECTID for en ASSOCIATIONS_CONTACTS_TO_DEALS-visning). |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev indlæst af BigQuery. |
associations-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede associations-tabel:
| Kolonnenavn | Type | Beskrivelse |
| KOMBINERETASSOCIATIONSTYPEID | STRING | Den unikke identifikator for associeringsdefinitionen. |
| FROMOBJECTID | INT64 | ID'et for kildeobjektet. |
| TOOBJECTID | INT64 | ID'et for destinationsobjektet. |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev indlæst af BigQuery. |
association_definitions-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede associations_definitions-tabel:
| Kolonnenavn | Type | Beskrivelse |
| COMBINEDASSOCIATIONTYPEID | STRING | Den unikke identifikator for den specifikke tilknytningsdefinition. |
| ASSOCIATIONCATEGORY | STRING | Oprindelsen til associationstypen. Mulige værdier omfatter: HUBSPOT_DEFINED, USER_DEFINED eller INTEGRATOR_DEFINED. |
| ASSOCIATIONTYPEID | STRING | En unik identifikator for en associeringsdefinition inden for dens ASSOCIATIONCATEGORY. Ingen to definitioner i samme kategori vil dele dette ID. |
| FROMOBJECTTYPEID | STRING | Objekttype-ID'et for associationens kildeobjekt. |
| FROMOBJECTTYPE | STRING | Navnet på foreningens kildeobjekttype. |
| TOOBJECTTYPEID | STRING | Objekttype-ID'et for foreningens målobjekt. |
| TOOBJECTTYPE | STRING | Navnet på foreningens destinationsobjekttype. |
| NAME | STRING | Det definerede navn på associeringsdefinitionen. |
| LABEL | STRING | En beskrivende etiket til associeringsdefinitionen. |
| ISMAINASSOCIATIONDEFINITION | BOOLEAN | Angiver, om dette er den primære associationstype (true), som er den, HubSpot viser på associerede poster. |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev indlæst af BigQuery. |
Begivenheder
Begivenheder omfatter standard HubSpot-begivenheder og brugerdefinerede adfærdsbegivenheder. Hver begivenhed har sit eget databaseobjekt, mærket som events_eventname.
| Navn | |
| EVENTS_AD_INTERACTION | Detaljer om en annonce og kontakter, der interagerede med den ved at klikke på annoncen eller indsende en formular efter at have interageret med den. |
| EVENTS_AD_METRICS_IMPORTED_V0 |
Oplysninger om en annonce og dens præstationsmålinger. |
| EVENTS_CALL_MENTIONED_KEYWORD | Detaljer om søgeord, der er nævnt af deltagere i opkald. |
| EVENTS_CLICKED_LINK_IN_EMAIL_V2 |
Links, som kontakter har klikket på i marketing-e-mails. |
| EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 | Links, som kontakter har klikket på i e-mails i Conversations-indbakken. |
| EVENTS_COOKIE_BANNER_CLICKED | Kontakter, der har klikket på cookies. |
| EVENTS_COOKIE_BANNER_VIEWED | Kontakter, der har set cookies. |
| EVENTS_DOCUMENT_SHARED_V2 | Salgsdokumenter, der er delt med kontakter via et eksternt link. |
| EVENTS_DOCUMENT_VIEWED_V2 | Salgsdokumenter og kontakter, der har set dem ved at åbne det eksterne link. |
| EVENTS_DOCUMENT_COMPLETED_V2 | Salgsdokumenter og kontakter, der har afsluttet dem. |
| EVENTS_HS_SCHEDULED_EMAIL_V2 | E-mails, der er sendt til HubSpots e-mailservere med henblik på afsendelse. |
| EVENTS_MTA_DELIVERED_EMAIL_V2 | E-mails, der er leveret til modtagerne af HubSpots e-mail-servere. |
| EVENTS_MTA_BOUNCED_EMAIL_V2 | Forsøg på at levere e-mails, der blev afvist af modtagerens e-mail-server. |
| EVENTS_OPENED_EMAIL_V2 | E-mails åbnet af kontakter. |
| EVENTS_REPORTED_SPAM_EMAIL_V2 | E-mails markeret som spam af modtagere. |
| EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 | Ændringer i e-mail-abonnementer foretaget af modtagere. |
| EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 | Åbninger af e-mails i indbakken af kontakter. |
| EVENTS_MB_MEDIA_PLAYED | Videoafspilningsaktivitet efter kontakter. |
| EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE | Kontakt har booket et møde via sekvens. |
| EVENTS_V2_KONTAKT_TILMELDET_TIL_SEKVENS | Kontakt tilmeldt fra sekvens. |
| EVENTS_V2_CONTACT_FINISHED_SEQUENCE | Sekvensen er afsluttet. |
| EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL | Kontakt har svaret på e-mail (eller indgående e-mail, der afmeldte sekvensen) sendt via sekvensen. |
| EVENTS_V2_KONTAKT_AFMELD_FRA_SEKVENS | Kontakt afmeldt fra sekvens. |
| EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE | Brugeren har manuelt afmeldt kontakten. |
| EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL | Kontakt har afmeldt sig og er dermed afmeldt sekvensen. |
| EVENTS_V2_SEQUENCE_EMAIL_BOUNCED | Sekvens-e-mailen blev returneret. |
| EVENTS_V2_SEQUENCE_ERRORED | Der opstod en fejl i sekvensen, hvilket medførte afmelding. |
| EVENTS_V2_SEQUENCE_STEP_EXECUTED | Sekvenstrin udført. |
| EVENTS_VISITED_PAGE | Besøg på websiden af kontakter. |
| EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> | Integrationsbegivenheder (Timeline V3 API) |
Du kan identificere begivenheder ved at kombinere deres begivenhedstype-ID og ID. De kolonner, der returneres, afhænger af begivenheden, med en kolonne for hver begivenhedsegenskab. Alle begivenheder returnerer følgende kolonner:
| Kolonnenavn | Type | Beskrivelse |
EVENTTYPEID |
STRING | ID'et for begivenhedstypen, svarende til OBJECTTYPEID Du kan søge på alle begivenhedstype-ID'er i din konto ved hjælp af visningen object_and_event_type_definitions. |
ID |
STRING | Dette er unikt for hver begivenhedstype. Der vil ikke være to poster med samme ID inden for en given begivenhedstype. |
OBJECTTYPEID |
STRING | Den type objekt, der gennemførte begivenheden. For eksempel vil et klik på et e-mail-link vise0-1 i denne kolonne, hvilket repræsenterer kontaktobjektet. |
OBJECTID |
INT64 | ID'et for den post, der gennemførte begivenheden. |
OCCURREDAT |
TIMESTAMP | Hvornår begivenheden fandt sted. |
|
|
INT64 | Et tal, der angiver, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen OCCURREDAT, men formateret som et tal og brugt som en del af tabellens klyngenøgle. I de fleste tilfælde kan du bruge OCCURREDAT tidsstemplet i stedet for dette tal. |
|
|
TAL | Et tal, der angiver, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen |
INGESTEDAT |
Tidsstempel | Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af BigQuery. Få mere at vide om kolonnedatatyper. |
PROPERTY_* |
Varchar | Individuelle kolonner, der indeholder begivenhedsegenskaberne. |