- Tietämyskanta
- Tili ja asetukset
- Integraatiot
- Yhdistä HubSpot Google BigQueryyn
BetaYhdistä HubSpot Google BigQueryyn
Päivitetty viimeksi: 1 kesäkuuta 2026
Synkronoi Google BigQueryn tiedot HubSpot CRM -objektien, kuten yhteystietojen, yritysten, sopimusten, yhdistysten ja muiden tilisi tietojen kanssa.
Alla olevissa osioissa käydään läpi, miten Google BigQuery -sovellus valtuutetaan ja miten sitten määritetään synkronointiasetukset Google Cloud -tilisi ja HubSpotin välillä.
Käyttöoikeudet edellytetään Sinun on oltava HubSpot-tilisi Super Admin, jotta voit asentaa integraation.
Google BigQuery -integraation yhdistäminen ja määrittäminen
Voit yhdistää Google BigQuery -tilisi HubSpotiin:
- Napsauta HubSpot-tilisi ylänavigointipalkin kauppakuvaketta
ja valitse HubSpot-kauppa. - Napsauta hakupalkkia ja kirjoita Google BigQuery.
- Napsauta Google BigQuery -kohtaa listaussivulta.
- Napsauta Asenna.
- Napsauta Jatka asennusta.
Sinut ohjataan tietojen integrointityökaluun, jossa sivuruutu opastaa sinua tietojen synkronoinnissa HubSpot- ja BigQuery-tileidesi välillä haluamiesi ohjeiden mukaan:
- Google BigQuery → HubSpot: Määritä synkronointi BigQuerystä HubSpotiin.
- HubSpot → Google BigQuery: määritä synkronointi HubSpotista BigQueryyn.
Synkronoi Google BigQuery -tiedot HubSpot-tilillesi.
HubSpot-krediittejä edellytetään HubSpot-krediittejä tarvitaan tietojen synkronointiin Google BigQuerystä HubSpotiin. Lue lisää siitä, miten HubSpot Credits toimii Data Studion kanssa.
Jos haluat lähettää Google BigQuery -tietoja HubSpotiin, lisää ja määritä BigQuery-tilillesi uusi käyttäjä, jolla on tarvittavat roolit:
- Valitse oikeasta ruudusta Google BigQuery → HubSpot.
- Kopioi Googlen palvelutilin sähköpostiosoite, jonka HubSpot luo.
- Siirry Google Cloud -tililläsi projektin IAM-asetuksiin, luo uusi käyttäjä HubSpotista kopioimallasi palvelutilin sähköpostilla ja lisää sitten BigQuery Data Viewer- ja BigQuery Job User -roolit äskettäin luodulle käyttäjälle.
- Kopioi projektitunnus Google Cloud -tililtäsi.
- Liitä takaisin HubSpotissa projektitunnus ja napsauta sitten Testaa yhteys.
- Kun yhteys on tarkistettu, valitse Next (Seuraava), jotta saat asetukset valmiiksi.
Synkronoi HubSpot-tiedot Google BigQuery -tilillesi.
Jos haluat lähettää HubSpot-tietoja Google BigQueryyn, määritä Google Cloud -tilillesi käyttäjä, jolla on tarvittavat oikeudet, sekä määritä siihen liittyvä GCP-projekti ja GCS-ämpärin URI.
Huomaa: tarvitset Google Cloudin ylläpitäjän oikeudet GCP-projektiin, jossa BigQuery-tietokokonaisuus sijaitsee, ja Google Cloud Storage (GCS) -kauhaan, johon HubSpot sijoittaa Parquet-tiedostot.
- Valitse oikeasta ruudusta HubSpot → Google BigQuery.
- Kopioi Googlen palvelutilin sähköpostiosoite, jonka HubSpot luo.
- Siirry Google Cloud -tililläsi projektin IAM-asetuksiin, luo uusi käyttäjä HubSpotista kopioimallasi palvelutilin sähköpostilla ja lisää sitten BigQuery Data Viewer-, BigQuery Job User- ja Storage-objektien omistajaroolit äskettäin luotua käyttäjää varten.
- Kopioi projektitunnus Google Cloud -tililtäsi.
- Liitä projektitunnus takaisin HubSpotissa.
- Lisää Google Cloud Storage (GCS) -kauhan URI:
- GCS-ämpärin URI:n tulisi noudattaa rakennetta:
gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/ - BigQueryn ulkoiset taulukot luodaan GCP-projektin omaan tietokokonaisuuteen ja ne noudattavat muotoa:
hubspot_data_set_{hubId} - Tiedot kirjoitetaan GCS-ämpäriin, ja niihin liittyvät taulukot viittaavat GCS:ssä oleviin parkettitiedostoihin.
- Lue lisää GCS-ämpäreiden luomisesta Googlen dokumentaatiosta.
- GCS-ämpärin URI:n tulisi noudattaa rakennetta:
- Napsauta Testaa yhteys.
- Kun yhteys on tarkistettu, napsauta Seuraava.
- Valitse valintaruudut niiden tietolähteiden vieressä, jotka haluat synkronoida (esim. yhteystiedot, yhdistykset, tapahtumat jne.).
- Määritä synkronointitiheys ja -aikataulu.
- Napsauta Käynnistä synkronointi.
Synkronoinnin seuranta
Kun olet määrittänyt tilien välisen synkronoinnin, voit tarkastella synkronoinnin tilaa ja historiaa synkronoinnin yksityiskohdat -sivulta:
- Siirry HubSpot-tililläsi kohtaan Tietojenhallinta > Tietojen integraatio.
- Napsauta Sovellussynkronoinnit-välilehteä kohdassa Tuonnin ja synkronointien seuranta.
- Napsauta hakupalkkia ja etsi Google BigQuery.
- Napsauta Google BigQuery. Huomaa, että näkyviin voi tulla useita merkintöjä, jos olet määrittänyt synkronoinnin molempiin suuntiin.
- Synkronoinnin tiedot -sivulla voit hallita ja tarkastella synkronointiasetuksia ja -historiaa:
- Voit arkistoida tai muokata synkronointitietoja valitsemalla oikeassa yläkulmassa Toiminnot ja valitsemalla sitten vastaavan vaihtoehdon.
- Jos haluat käynnistää synkronoinnin välittömästi, valitse oikeassa yläkulmassa Synkronoi nyt.
- Synkronoidut tietueet, yhdistelmät ja virheet esitetään yhteenvetona sivun yläosassa.
- Viimeisimmät synkronointitoiminnot näkyvät taulukossa. Napsauta Synkronointihistoria-välilehteä tarkastellaksesi tiettyjä synkronointiyrityksiä ja -päätösten tuloksia. Voit suodattaa tiettyjen päivämäärävyöhykkeiden tai synkronointitilan mukaan.
Synkronoinnin tilat ja virheiden käsittely
Alla olevassa taulukossa esitetään mahdolliset synkronointitilat:
| Tila | Kuvaus |
| Synkronointi | Synkronointiyritys on parhaillaan käynnissä. |
| Synkronoitu | Viimeisin synkronointi on suoritettu onnistuneesti. |
| Failed | Viimeisimmässä synkronoinnissa tapahtui virhe. |
| Arkistoitu | Synkronointikonfiguraatio poistettiin manuaalisesti, mutta sitä voidaan tarkastella jälkikäteen. |
Jos synkronointi epäonnistuu:
- Synkronointitiedot-sivulla näkyy Epäonnistunut-tila sekä tiedot siitä, mitkä taulukot onnistui tai epäonnistui synkronointi.
- Tietoja ei kirjoiteta osittain, jos synkronointi epäonnistuu: BigQuery-taulukot päivittyvät vain synkronoinnin onnistuessa.
- Seuraavassa ajoitetussa synkronoinnissa yritetään automaattisesti uudelleen täydellistä synkronointia.
- Voit käynnistää uuden synkronoinnin manuaalisesti milloin tahansa synkronoinnin yksityiskohdat -sivulta.
Verkon salliminen
HubSpotin tietojen synkronointi kolmannen osapuolen palveluntarjoajille, kuten BigQuerylle, ohjataan HubSpotin välityspalvelimen IP-osoitteiden kautta. Näitä IP-alueita käyttävät muut HubSpotin integraatiot, kuten tietojen synkronointi ja webhooks.
Jos organisaatiosi rajoittaa GCP-resurssien saapuvaa pääsyä, sinun tulisi sallia seuraavat CIDR-alueet HubSpot-hubletin perusteella:
| Hublet | CIDR |
| NA1 | 54.174.62.128/26 |
| NA2 | 216.157.40.32/27 |
| NA3 | 216.157.41.32/27 |
| EU1 | 143.244.87.0/25 |
| AP1 | 216.157.42.32/27 |
Lue, miten saat selville , missä HubSpot-tilisi tiedot sijaitsevat.
Beta-rajoitukset
Pidä seuraavat rajoitukset mielessäsi tämän betatestin aikana:
- Synkronointitiheys: käytettävissä on vain rajoitettu määrä synkronointitiheyksiä, kuten kerran, 6 tunnin välein, 12 tunnin välein, päivittäin, viikoittain ja kuukausittain. Voit käynnistää uudelleensynkronoinnin manuaalisesti HubSpotin synkronointitietosivulta milloin tahansa.
- Yksi vienti tietotyyppiä kohti: Kukin objektityyppi, tapahtumatyyppi tai yhdistelmäpari voidaan viedä vain yhdellä synkronointimäärityksellä HubSpot-tiliä kohti.
- Jos esimerkiksi yhteystietoja viedään jo yhteen BigQuery-kohteeseen, niitä ei voi lisätä toiseen kokoonpanoon ennen kuin alkuperäinen kohde on arkistoitu.
- Näin estetään päällekkäiset dataputket ja varmistetaan, että tietovarastossasi on yksi totuuden lähde tietotyyppiä kohti.
- Rajoitettu tuki arkaluonteisille tiedoille: Voit tallentaa ja synkronoida arkaluonteisia tietoja HubSpot-tilillesi, mutta et voi synkronoida arkaluonteisia tietoja BigQuery-tilillesi.
- Ei tukea object_x_views -objekteille: object_x_views -objektia ei tällä hetkellä tueta synkronoinnissa BigQueryn kanssa. Käytä
object_with_object_propertiestai liitäobjectsjaobject_propertiesyhteen saadaksesi vastaavat tietuekohtaiset näkymät.
Seuraavat vaiheet
Kun olet yhdistänyt BigQuery-integraation ja määrittänyt synkronointiasetukset, tutustu BigQueryn synkronoitujen taulujen skeemaan.