- Kunnskapsdatabase
- Konto og oppsett
- Integrasjoner
- Få tilgang til HubSpot-data i Google BigQuery (BETA)
I betaFå tilgang til HubSpot-data i Google BigQuery (BETA)
Sist oppdatert: 1 juni 2026
Tilgjengelig med et av følgende abonnementer, unntatt der det er angitt:
-
Data Hub Enterprise
Når du har koblet Google BigQuery til HubSpot-kontoen din, kan du hente ut HubSpot-data i BigQuery.
Denne artikkelen gir informasjon om skjemaet for hver tabell som er synkronisert til BigQuery, som du kan bruke sammen med Googles dokumentasjon for å søke etter HubSpot-data i BigQuery-kontoen din.
Dataoversikt
Søk konstrueres ved hjelp av SQL og kan brukes til å hente HubSpot-data som:
- Objekter: standard- og tilpassede objekter, for eksempel kontakter, selskaper, produkter.
- Post: individuelle poster, for eksempel en enkelt kontakt eller et enkelt selskap.
- Assosiasjoner: alle tilgjengelige assosiasjonstyper og poster som for øyeblikket er assosiert.
- Hendelser: hendelsesdata for både standard HubSpot-hendelser, for eksempel åpning av e-post, og tilpassede atferdshendelser.
Objektdata av forskjellige typer kombineres for v1: alle poster for alle objekttyper kombineres til ett databaseobjekt. Når du søker, må du derfor spesifisere et filter som “WHERE objectTypeId=’0-1’
Tilpassede objekter vil bli tildelt en ID ved opprettelsen, og vil bli identifisert som 2-unique_ID. For eksempel 2-12345.
Lær mer om HubSpots CRM-datamodell.
Synkroniserte tabellskjemaer
Avsnittene nedenfor gir detaljer om skjemaet for hver tabell som synkroniseres fra HubSpot-kontoen din til BigQuery, basert på de konfigurerte synkroniseringsinnstillingene dine.
object_properties-skjema
Skjemaet nedenfor gir detaljer om den synkroniserte object_properties-tabellen:
| Kolonnenavn | Type | Beskrivelse |
| OBJECTTYPEID | STRING | ID-en til objekttypen (f.eks. 0-1 for kontakter). |
| OBJECTID | INT64 | ID-en til posten (f.eks. 123752 som et eksempel på en kontaktpost). |
| NAME | STRING | Navnet på egenskapen. |
| VERDI | JSON | Verdien av egenskapen |
| UPDATEDAT | TIDSTEMPEL | Dato og klokkeslett for når posten sist ble oppdatert i HubSpot. |
| INGESTEDAT | TIDSTEMPEL | Dato og klokkeslett for når posten sist ble importert av BigQuery. |
object_with_object_properties-skjema
Skjemaet nedenfor gir detaljer om den synkroniserte tabellen object_with_object_properties:
| Kolonnenavn | Type | Beskrivelse |
| OBJECTTYPEID | STRING | ID-en til objekttypen (f.eks. 0-1 for kontakter). |
| OBJECTID | INT64 | ID-en til posten (f.eks. 123752 som et eksempel på en kontaktpost). |
| EGENSKAPER | JSON | Postens egenskapsverdier |
| UPDATEDAT | TIMESTAMP | Dato og klokkeslett for når posten sist ble oppdatert i HubSpot. |
| INGESTEDAT | TIDSTEMPEL | Dato og klokkeslett for når posten sist ble importert av BigQuery. |
associations_x_to_y-skjema
Skjemaet nedenfor gir detaljer om den synkroniserte tabellen associations_x_to_y_:
| Kolonnenavn | Type | Beskrivelse |
| COMBINEDASSOCIATIONTYPEID | STRING | Den unike identifikatoren for den spesifikke assosiasjonsdefinisjonen. |
| ASSOCIATIONCATEGORY | STRING | Opprinnelsen til assosiasjonstypen. Mulige verdier inkluderer: HUBSPOT_DEFINED, USER_DEFINED eller INTEGRATOR_DEFINED. |
| ASSOCIATIONTYPEID | STRING | En unik identifikator for en assosiasjonsdefinisjon innenfor sin ASSOCIATIONCATEGORY. Ingen to definisjoner i samme kategori vil dele denne ID-en. |
| FROMOBJECTTYPEID | STRING | Objekttype-ID-en til assosiasjonens kildeobjekt. |
| FROMOBJECTTYPE | STRING | Navnet på assosiasjonens kildeobjekttype. |
| TOOBJECTTYPEID | STRING | Objekttype-ID-en til assosiasjonens målobjekt. |
| TOOBJECTTYPE | STRING | Navnet på assosiasjonens destinasjonsobjekttype. |
| NAME | STRING | Det definerte navnet på assosiasjonsdefinisjonen. |
| LABEL | STRING | En beskrivende etikett for assosiasjonsdefinisjonen. |
| ISMAINASSOCIATIONDEFINITION | BOOLEAN | Angir om dette er den primære assosiasjonstypen (true), som er den HubSpot viser på tilknyttede poster. |
| [FROMOBJECTTYPE_OBJECTID] | INT64 | Objekt-ID-en til kildeposten. (f.eks. CONTACT_OBJECTID for en ASSOCIATIONS_CONTACTS_TO_DEALS-visning). |
| [TOOBJECTTYPE_OBJECTID] | INT64 | Objekt-ID-en til målposten. (f.eks. DEAL_OBJECTID for en ASSOCIATIONS_CONTACTS_TO_DEALS-visning). |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslett for når posten sist ble importert av BigQuery. |
associations-skjema
Skjemaet nedenfor gir detaljer om den synkroniserte tabellen associations:
| Kolonnenavn | Type | Beskrivelse |
| KOMBINERTASSOSIASJONSTYPEID | STRING | Den unike identifikatoren for assosiasjonsdefinisjonen. |
| FRAOBJEKTID | INT64 | ID-en til kildeobjektet. |
| TOOBJECTID | INT64 | ID-en til målobjektet. |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslett for når posten sist ble importert av BigQuery. |
association_definitions-skjema
Skjemaet nedenfor gir detaljer om den synkroniserte tabellen associations_definitions:
| Kolonnenavn | Type | Beskrivelse |
| COMBINEDASSOCIATIONTYPEID | STRING | Den unike identifikatoren for den spesifikke assosiasjonsdefinisjonen. |
| ASSOCIATIONCATEGORY | STRING | Opprinnelsen til assosiasjonstypen. Mulige verdier inkluderer: HUBSPOT_DEFINED, USER_DEFINED eller INTEGRATOR_DEFINED. |
| ASSOCIATIONTYPEID | STRING | En unik identifikator for en assosiasjonsdefinisjon innenfor sin ASSOCIATIONCATEGORY. Ingen to definisjoner i samme kategori vil dele denne ID-en. |
| FROMOBJECTTYPEID | STRING | Objekttype-ID-en til assosiasjonens kildeobjekt. |
| FROMOBJECTTYPE | STRING | Navnet på assosiasjonens kildeobjekttype. |
| TOOBJECTTYPEID | STRING | Objekttype-ID-en til assosiasjonens målobjekt. |
| TOOBJECTTYPE | STRING | Navnet på assosiasjonens destinasjonsobjekttype. |
| NAME | STRING | Det definerte navnet på assosiasjonsdefinisjonen. |
| LABEL | STRING | En beskrivende etikett for assosiasjonsdefinisjonen. |
| ISMAINASSOCIATIONDEFINITION | BOOLEAN | Angir om dette er den primære assosiasjonstypen (true), som er den HubSpot viser på tilknyttede poster. |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslett for når posten sist ble importert av BigQuery. |
Hendelser
Hendelser inkluderer standard HubSpot-hendelser og tilpassede atferdshendelser. Hver hendelse har sitt eget databaseobjekt, merket som events_eventname.
| Navn | |
| EVENTS_AD_INTERACTION | Detaljer om en annonse og kontakter som har interagert med den ved å klikke på annonsen eller sende inn et skjema etter å ha engasjert seg med den. |
| EVENTS_AD_METRICS_IMPORTED_V0 |
Detaljer om en annonse og dens ytelsesmålinger. |
| EVENTS_CALL_MENTIONED_KEYWORD | Detaljer om søkeord nevnt av deltakere i samtaler. |
| EVENTS_CLICKED_LINK_IN_EMAIL_V2 |
Lenker som kontakter har klikket på i markedsførings-e-poster. |
| EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 | Lenker som kontakter har klikket på i e-poster i Conversations-innboksen. |
| EVENTS_COOKIE_BANNER_CLICKED | Kontakter som har klikket på informasjonskapsler. |
| EVENTS_COOKIE_BANNER_VIEWED | Kontakter som har sett på informasjonskapsler. |
| EVENTS_DOCUMENT_SHARED_V2 | Salgsdokumenter som er delt med kontakter via en ekstern lenke. |
| EVENTS_DOCUMENT_VIEWED_V2 | Salgsdokumenter og kontakter som har sett dem ved å åpne den eksterne lenken. |
| EVENTS_DOCUMENT_COMPLETED_V2 | Salgsdokumenter og kontakter som har avsluttet dem. |
| EVENTS_HS_SCHEDULED_EMAIL_V2 | E-poster som er sendt til HubSpot-e-postserverne for å bli sendt. |
| EVENTS_MTA_DELIVERED_EMAIL_V2 | E-poster som er levert til mottakerne av HubSpots e-postservere. |
| EVENTS_MTA_BOUNCED_EMAIL_V2 | Forsøk på levering av e-post som ble avvist av mottakerens e-postserver. |
| EVENTS_OPENED_EMAIL_V2 | E-post åpnet av kontakter. |
| EVENTS_REPORTED_SPAM_EMAIL_V2 | E-poster merket som spam av mottakere. |
| EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 | Endringer i e-postabonnementer av mottakere. |
| EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 | Åpninger av e-post i innboksen registrert av kontakter. |
| EVENTS_MB_MEDIA_PLAYED | Videoavspillingsaktivitet etter kontakter. |
| EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE | Kontakten har booket et møte gjennom sekvensen. |
| EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE | Kontakten har meldt seg på fra sekvensen. |
| EVENTS_V2_CONTACT_FINISHED_SEQUENCE | Sekvensen er fullført. |
| EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL | Kontakten svarte på e-post (eller innkommende e-post som avmeldte sekvensen) sendt gjennom sekvensen. |
| EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE | Kontakten har meldt seg ut av sekvensen. |
| EVENTS_V2_CONTACT_MANUELL_AVMELDING_FRA_SEKVENS | Brukeren har manuelt meldt kontakten ut. |
| EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL | Kontakten har meldt seg av, og er dermed ikke lenger registrert i sekvensen. |
| EVENTS_V2_SEQUENCE_EMAIL_BOUNCED | Sekvens-e-posten ble returnert. |
| EVENTS_V2_SEQUENCE_ERRORED | Feil i sekvensen førte til avmelding. |
| EVENTS_V2_SEQUENCE_STEP_EXECUTED | Sekvenssteg utført. |
| EVENTS_VISITED_PAGE | Besøk på nettsider av kontakter. |
| EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> | Integrasjonshendelser (Timeline V3 API) |
Du kan identifisere hendelser ved å kombinere hendelsestype-ID og ID. Kolonnene som returneres, avhenger av hendelsen, med én kolonne for hver hendelsesegenskap. Alle hendelser returnerer følgende kolonner:
| Kolonnenavn | Type | Beskrivelse |
EVENTTYPEID |
STRING | ID-en til hendelsestypen, tilsvarende OBJECTTYPEID Du kan søke etter alle hendelsestype-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions. |
ID |
STRING | Dette er unikt for hver hendelsestype. Ingen to poster vil ha samme ID innenfor en gitt hendelsestype. |
OBJECTTYPEID |
STRING | Typen objekt som fullførte hendelsen. For eksempel vil et klikk på en e-postlenke vise0-1 i denne kolonnen, som representerer kontaktobjektet. |
OBJECTID |
INT64 | ID-en til posten som fullførte hendelsen. |
OCCURREDAT |
TIMESTAMP | Når hendelsen skjedde. |
|
|
INT64 | Et tall som angir når hendelsen skjedde. Inneholder de samme dataene som OCCURREDAT kolonnen, men er formatert som et tall og brukes som en del av tabellens klyngenøkkel. I de fleste tilfeller kan du bruke OCCURREDAT i stedet for dette tallet. |
|
|
Tall | Et tall som angir når hendelsen skjedde. Inneholder de samme dataene som kolonnen |
INGESTEDAT |
Tidsstempel | Dato og klokkeslett for når dataene sist ble importert av BigQuery. Les mer om kolonnedatatyper. |
PROPERTY_* |
Varchar | Enkeltkolonner som inneholder hendelsesegenskapene. |