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ä.

HubSpot-tietojen käyttö Google BigQuery -palvelussa (BETA)

Päivitetty viimeksi: 30 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 tehdä kyselyjä HubSpot-tiedoista BigQuery-palvelussa.

Tässä artikkelissa on tietoa jokaisen BigQueryyn synkronoidun taulukon skeemasta. Voit käyttää näitä tietoja yhdessä Googlen ohjeiden kanssa, kun haet HubSpot-tietoja BigQuery-tililtäsi.

Tietojen yleiskatsaus

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

Objektit: vakio- ja mukautetut objektit, kuten yhteyshenkilöt, 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 kyselyjä tehdessäsi sinun on määritettävä suodatin, kuten “WHERE objectTypeId=’0-1’

Mukautetuille objekteille annetaan tunnus niiden luomisen yhteydessä, ja ne tunnistetaan muodossa 2-unique_ID. Esimerkiksi 2-12345.

Lisätietoja HubSpotin CRM-tietomallista.

Synkronoidut taulukkoskeemat

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

object_properties-rakenteesta

Alla oleva rakenne sisältää yksityiskohtaisia tietoja synkronoidusta object_properties-taulukosta:

Sarakkeen nimi	Tyyppi	Kuvaus
OBJECTTYPEID	MERKKIJONO	Objektityypin tunniste (esim. 0–1 yhteystiedoille).
OBJECTID	INT64	Tietueen tunniste (esim. 123752 esimerkkinä yhteystietotietueesta).
NAME	STRING	Ominaisuuden nimi.
ARVO	JSON	Ominaisuuden arvo
PÄIVITYSPÄIVÄMÄÄRÄ	TIMESTAMP	Päivämäärä ja kellonaika, jolloin tietuetta viimeksi päivitettiin HubSpotissa.
INGESTEDAT	TIMESTAMP	Päivämäärä ja kellonaika, jolloin BigQuery on viimeksi tuonut tietueen järjestelmään.

object_with_object_properties-skeema

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

Sarakkeen nimi	Tyyppi	Kuvaus
OBJECTTYPEID	MERKKIJONO	Objektityypin tunniste (esim. 0–1 yhteystiedoille).
OBJECTID	INT64	Tietueen tunniste (esim. 123752 esimerkkinä yhteystietotietueesta).
OMINAISUUDET	JSON	Tietueen ominaisuusarvot
PÄIVITYSPÄIVÄMÄÄRÄ	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 tuonut tietueen järjestelmään.

associations-skeema

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

Sarakkeen nimi	Tyyppi	Kuvaus
COMBINEDASSOCIATIONTYPEID	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 skeema sisältää tiedot synkronoidusta associations_definitions-taulukosta:

Sarakkeen nimi	Tyyppi	Kuvaus
COMBINEDASSOCIATIONTYPEID	MERKKIJONO	Tietyn assosiaatiomääritelmän yksilöllinen tunniste.
ASSOCIATIONCATEGORY	MERKKIJONO	Yhdistelmätyypin alkuperä. Mahdollisia arvoja ovat: HUBSPOT_DEFINED, USER_DEFINED tai INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	MERKKIJONO	Yksilöllinen tunniste assosiaatiomääritelmälle sen ASSOCIATIONCATEGORY-luokassa. Samassa luokassa olevilla määritelmillä ei voi olla samaa tunnusta.
FROMOBJECTTYPEID	MERKKIJONO	Yhdistyksen lähdeobjektin objektityypin tunniste.
FROMOBJECTTYPE	MERKKIJONO	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 kyseessä 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 vastaan.

Tapahtumat

Tapahtumat sisältävät HubSpotin vakiotapahtumat 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 sitä 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 puheluissa.
EVENTS_CALL_MENTIONED_KEYWORD	Yhteyshenkilöiden markkinointisähköposteissa 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 yhteyshenkilöille 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 saattaneet ne päätökseen.
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 seurannassa olevassa postilaatikossa.
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, jolla hän poistui sekvenssistä).
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Yhteyshenkilö on poistunut sekvenssistä.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Käyttäjä poisti kontaktin manuaalisesti sekvenssistä.
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 ilmeni virhe, joka johti poistumiseen.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenssin vaihe suoritettu.
EVENTS_VISITED_PAGE	Yhteyshenkilöiden verkkosivuvierailut.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrointitapahtumat (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	Tunnus on yksilöllinen kunkin tapahtumatyypin osalta. Kahdella tietueella ei voi olla samaa tunnusta saman tapahtumatyypin sisällä.
`OBJECTTYPEID`	MERKKIJONO	Tapahtuman suorittaneen objektin tyyppi. Esimerkiksi sähköpostilinkin klikkauksessa tässä sarakkeessa näkyy`0-1`, mikä edustaa kontaktiobjektia.
`OBJECTID`	INT64	Tapahtuman suorittaneen tietueen tunnus.
`OCCURREDAT`	TIMESTAMP	Tapahtuman ajankohta.
`OCCURREDATDATEINT`	INT64	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.
`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 BigQuery on viimeksi ottanut tiedot vastaan. Lue lisää 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.

BetaHubSpot-tietojen käyttö Google BigQuery -palvelussa (BETA)