Huomaa: Tämän artikkelin käännös on tarkoitettu vain tiedoksi. Käännös on luotu automaattisesti käännösohjelmiston avulla, eikä sitä ole välttämättä tarkistettu. Näin ollen tämän artikkelin englanninkielistä versiota on pidettävä hallitsevana versiona, joka sisältää uusimmat tiedot. Voit tutustua siihen täällä.

Pääsy HubSpotin tietoihin Google BigQueryssä (BETA)

Päivitetty viimeksi: 1 kesäkuuta 2026

Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:

Data Hub Enterprise

Kun olet liittänyt Google BigQueryn HubSpot-tiliisi, voit hakea HubSpot-tietoja BigQuery-palvelusta.

Tässä artikkelissa on tietoa jokaisen BigQueryyn synkronoidun taulukon skeemasta, jota voit käyttää yhdessä Googlen ohjeiden kanssa HubSpot-tietojen hakemiseen BigQuery-tililläsi.

Tietojen yleiskatsaus

Kyselyt laaditaan SQL-kielellä, ja niiden avulla voidaan hakea esimerkiksi seuraavia HubSpot-tietoja:

Objektit: vakio- ja mukautetut objektit, kuten yhteystiedot, yritykset ja tuotteet.
Tietueet: yksittäiset tietueet, kuten yksittäinen kontakti tai yritys.
Yhteydet: kaikki käytettävissä olevat yhteystyypit ja tällä hetkellä liitetyt tietueet.
Tapahtumat: tapahtumatiedot sekä HubSpotin vakiotapahtumista, kuten sähköpostien avaamisista, että mukautetuista käyttäytymistapahtumista.

Erilaiset objektitiedot yhdistetään versiossa v1: kaikkien objektityyppien kaikki tietueet yhdistetään yhdeksi tietokantaobjektiksi. Siksi kyselyissä on määritettävä suodatin, kuten “WHERE objectTypeId=’0-1’

Mukautetut objektit saavat luomishetkellä tunnuksen, joka tunnistetaan muodossa 2-unique_ID. Esimerkiksi 2-12345.

Lisätietoja HubSpotin CRM-tietomallista.

Synkronoidut taulukkoskeemat

Seuraavissa osioissa on yksityiskohtaisia tietoja kunkin taulukon skeemasta, joka on synkronoitu HubSpot-tililtäsi BigQueryyn määrittämiesi synkronointiasetusten perusteella.

object_properties-skeema

Alla oleva rakenne sisältää yksityiskohdat synkronoidusta object_properties-taulukosta:

Sarakkeen nimi	Tyyppi	Kuvaus
OBJECTTYPEID	STRING	Objektityypin tunnus (esim. 0–1 yhteystiedoille).
OBJECTID	INT64	Tietueen tunnus (esim. 123752 esimerkkinä yhteystietotietueesta).
NAME	STRING	Ominaisuuden nimi.
ARVO	JSON	Ominaisuuden arvo
PÄIVITETTY	TIMESTAMP	Päivämäärä ja kellonaika, jolloin tietue päivitettiin viimeksi HubSpotissa.
INGESTEDAT	TIMESTAMP	Päivämäärä ja kellonaika, jolloin BigQuery on viimeksi ottanut tietueen vastaan.

object_with_object_properties-skeema

Alla oleva rakenne sisältää tiedot synkronoidusta object_with_object_properties-taulukosta:

Sarakkeen nimi	Tyyppi	Kuvaus
OBJECTTYPEID	STRING	Objektityypin tunnus (esim. 0–1 yhteystiedoille).
OBJECTID	INT64	Tietueen tunnus (esim. 123752 esimerkkinä yhteystietotietueesta).
OMINAISUUDET	JSON	Tietueen ominaisuusarvot
PÄIVITETTY	TIMESTAMP	Päivämäärä ja kellonaika, jolloin tietue päivitettiin viimeksi HubSpotissa.
INGESTEDAT	TIMESTAMP	Päivämäärä ja kellonaika, jolloin BigQuery on viimeksi ottanut tietueen vastaan.

associations_x_to_y-skeema

Alla oleva skeema sisältää tiedot synkronoidusta associations_x_to_y-taulukosta:

Sarakkeen nimi	Tyyppi	Kuvaus
COMBINEDASSOCIATIONTYPEID	MERKKIJONO	Tietyn assosiaatiomääritelmän yksilöllinen tunniste.
ASSOCIATIONCATEGORY	STRING	Yhdistämistyyppien alkuperä. Mahdollisia arvoja ovat: HUBSPOT_DEFINED, USER_DEFINED tai INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	MERKKIJONO	Yksilöllinen tunniste assosiaatiomääritelmälle sen ASSOCIATIONCATEGORY-luokassa. Kahdella määritelmällä samassa luokassa ei voi olla samaa tunnusta.
FROMOBJECTTYPEID	MERKKIJONO	Yhdistyksen lähdeobjektin objektityypin tunniste.
FROMOBJECTTYPE	STRING	Yhdistyksen lähdeobjektityypin nimi.
TOOBJECTTYPEID	STRING	Yhdistyksen kohdeobjektin objektityypin tunnus.
TOOBJECTTYPE	STRING	Yhdistyksen kohdeobjektityypin nimi.
NAME	STRING	Yhdistelmämäärittelyn määritelty nimi.
LABEL	MERKKIJONO	Yhdistelmämäärittelyn kuvaava nimike.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Ilmaisee, onko tämä ensisijainen assosiaatiotyyppi (true), joka on se, jonka HubSpot näyttää assosioituneissa tietueissa.
[FROMOBJECTTYPE_OBJECTID]	INT64	Lähdetietueen objektitunnus. (esim. CONTACT_OBJECTID näkymässä ASSOCIATIONS_CONTACTS_TO_DEALS).
[TOOBJECTTYPE_OBJECTID]	INT64	Kohdetietueen objektitunnus. (esim. DEAL_OBJECTID näkymässä ASSOCIATIONS_CONTACTS_TO_DEALS).
INGESTEDAT	TIMESTAMP	Päivämäärä ja kellonaika, jolloin BigQuery on viimeksi ottanut tietueen vastaan.

associations-skeema

Alla oleva skeema sisältää tiedot synkronoidusta associations-taulukosta:

Sarakkeen nimi	Tyyppi	Kuvaus
YHDISTETTYYHDISTYSTYYPPIID	MERKKIJONO	Yhdistelmämäärittelyn yksilöllinen tunniste.
FROMOBJECTID	INT64	Lähdeobjektin tunniste.
TOOBJECTID	INT64	Kohdeobjektin tunnus.
INGESTEDAT	TIMESTAMP	Päivämäärä ja kellonaika, jolloin BigQuery on viimeksi ottanut tietueen vastaan.

association_definitions-skeema

Alla oleva kaavio sisältää tiedot synkronoidusta associations_definitions-taulukosta:

Sarakkeen nimi	Tyyppi	Kuvaus
COMBINEDASSOCIATIONTYPEID	MERKKIJONO	Tietyn assosiaatiomääritelmän yksilöllinen tunniste.
ASSOCIATIONCATEGORY	STRING	Yhdistämistyyppien alkuperä. Mahdollisia arvoja ovat: HUBSPOT_DEFINED, USER_DEFINED tai INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	MERKKIJONO	Yksilöllinen tunniste assosiaatiomääritelmälle sen ASSOCIATIONCATEGORY-luokassa. Kahdella määritelmällä samassa luokassa ei voi olla samaa tunnusta.
FROMOBJECTTYPEID	MERKKIJONO	Yhdistyksen lähdeobjektin objektityypin tunniste.
FROMOBJECTTYPE	STRING	Yhdistyksen lähdeobjektityypin nimi.
TOOBJECTTYPEID	STRING	Yhdistyksen kohdeobjektin objektityypin tunnus.
TOOBJECTTYPE	STRING	Yhdistyksen kohdeobjektityypin nimi.
NAME	STRING	Yhdistelmämäärittelyn määritelty nimi.
LABEL	MERKKIJONO	Yhdistelmämäärittelyn kuvaava nimike.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Ilmaisee, onko tämä ensisijainen assosiaatiotyyppi (true), joka on se, jonka HubSpot näyttää assosioituneissa tietueissa.
INGESTEDAT	TIMESTAMP	Päivämäärä ja kellonaika, jolloin BigQuery on viimeksi ottanut tietueen käyttöön.

Tapahtumat

Tapahtumat sisältävät tavalliset HubSpot-tapahtumat ja mukautetut käyttäytymistapahtumat. Jokaisella tapahtumalla on oma tietokantaobjektinsa, jonka nimi on events_eventname.

Nimi
EVENTS_AD_INTERACTION	Mainoksen tiedot ja kontaktit, jotka ovat olleet vuorovaikutuksessa mainoksen kanssa napsauttamalla mainosta tai lähettämällä lomakkeen sen kanssa vuorovaikutuksen jälkeen.
EVENTS_AD_METRICS_IMPORTED_V0	Mainoksen tiedot ja sen suorituskykymittarit.
EVENTS_CALL_MENTIONED_KEYWORD	Tiedot avainsanoista, jotka osallistujat ovat maininneet puhelinkeskusteluissa.
EVENTS_CALL_MENTIONED_KEYWORD	Yhteyshenkilöiden markkinointiviesteissä klikkaamat linkit.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Yhteyshenkilöiden Conversations-postilaatikon sähköposteissa napsautetut linkit.
EVENTS_COOKIE_BANNER_CLICKED	Yhteyshenkilöt, jotka ovat napsauttaneet evästeitä.
EVENTS_COOKIE_BANNER_VIEWED	Yhteyshenkilöt, jotka ovat katsoneet evästeitä.
EVENTS_DOCUMENT_SHARED_V2	Myyntiasiakirjat, jotka on jaettu kontakteille ulkoisen linkin kautta.
EVENTS_DOCUMENT_VIEWED_V2	Myyntiasiakirjat ja yhteyshenkilöt, jotka ovat katsoneet niitä avaamalla ulkoisen linkin.
EVENTS_DOCUMENT_COMPLETED_V2	Myyntiasiakirjat ja yhteyshenkilöt, jotka ovat sulkeneet ne.
EVENTS_HS_SCHEDULED_EMAIL_V2	HubSpotin sähköpostipalvelimille lähetettäväksi toimitetut sähköpostit.
EVENTS_MTA_DELIVERED_EMAIL_V2	HubSpotin sähköpostipalvelimien vastaanottajille onnistuneesti toimittamat sähköpostit.
EVENTS_MTA_BOUNCED_EMAIL_V2	Sähköpostin toimitusyritykset, jotka vastaanottajan sähköpostipalvelin on hylännyt.
EVENTS_OPENED_EMAIL_V2	Yhteyshenkilöiden avaamat sähköpostit.
EVENTS_REPORTED_SPAM_EMAIL_V2	Vastaanottajien roskapostiksi merkitsemät sähköpostit.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Vastaanottajien tekemät muutokset sähköpostitilauksiin.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Yhteyshenkilöiden avaamat sähköpostit saapuneet-kansiossa.
EVENTS_MB_MEDIA_PLAYED	Yhteyshenkilöiden videotoistotoiminta.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Yhteyshenkilö on varannut tapaamisen sekvenssin kautta.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Yhteyshenkilö on ilmoittautunut sekvenssiin.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvenssi on päättynyt.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Yhteyshenkilö vastasi sekvenssin kautta lähetettyyn sähköpostiin (tai saapuneeseen sähköpostiin, joka poisti rekisteröinnin sekvenssistä).
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Yhteyshenkilö on poistunut sekvenssistä.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Käyttäjä poisti kontaktin manuaalisesti.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Yhteyshenkilö on peruuttanut tilauksensa, jolloin hänet on poistettu sekvenssistä.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sarjan sähköposti palautui.
EVENTS_V2_SEQUENCE_ERRORED	Sarjassa tapahtui virhe, joka johti poistumiseen.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenssin vaihe suoritettu.
EVENTS_VISITED_PAGE	Yhteyshenkilöiden verkkosivuvierailut.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integraatiotapahtumat (Timeline V3 API)

Voit tunnistaa tapahtumat yhdistämällä niiden tapahtumatyypin tunnuksen ja tunnuksen. Palautettavat sarakkeet riippuvat tapahtumasta, ja jokaiselle tapahtuman ominaisuudelle on yksi sarake. Kaikista tapahtumista palautetaan seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`EVENTTYPEID`	MERKKIJONO	Tapahtumatyypin tunnus, samanlainen kuin OBJECTTYPEID Voit hakea kaikki tilisi tapahtumatyyppitunnukset object_and_event_type_definitions -näkymän avulla.
`ID`	MERKKIJONO	Tämä on yksilöllinen kunkin tapahtumatyypin osalta. Kahdella tietueella ei voi olla samaa tunnusta tietyn tapahtumatyypin sisällä.
`OBJECTTYPEID`	STRING	Tapahtuman suorittaneen objektin tyyppi. Esimerkiksi sähköpostilinkin klikkaus näkyy tässä sarakkeessa`0-1`, joka edustaa kontaktiobjektia.
`OBJECTID`	INT64	Tapahtuman suorittaneen tietueen tunnus.
`OCCURREDAT`	TIMESTAMP	Milloin tapahtuma tapahtui.
`OCCURREDATDATEINT`	INT64	Luku, joka edustaa tapahtuman ajankohtaa. Sisältää samat tiedot kuin `OCCURREDAT` ake, mutta muotoiltuna lukuna ja käytettynä osana taulukon klusteriavainta. Useimmissa tapauksissa voit käyttää `OCCURREDAT` tämän luvun sijaan.
`OCCUREDATDATEINT`	Luku	Luku, joka edustaa tapahtuman ajankohtaa. Sisältää samat tiedot kuin `OCCURREDAT` ake, mutta on muotoiltu lukuna ja sitä käytetään osana taulukon klusteriavainta. Useimmissa tapauksissa voit käyttää `OCCURREDAT` tämän luvun sijaan.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin tiedot on viimeksi tuotu BigQueryyn. Lisätietoja sarakkeiden tietotyypeistä.
`PROPERTY_*`	Varchar	Yksittäiset sarakkeet, jotka sisältävät tapahtuman ominaisuudet.

Oliko tästä artikkelista apua?

Tätä lomaketta käytetään vain dokumentaation palautteeseen. Lue, miten saat apua HubSpotin kanssa.

BetaPääsy HubSpotin tietoihin Google BigQueryssä (BETA)