- Tietämyskanta
- Tili ja asetukset
- Integraatiot
- Yhdistä HubSpot Google BigQueryyn
BetaYhdistä HubSpot Google BigQueryyn
Päivitetty viimeksi: 30 heinäkuuta 2026
Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:
-
Data Hub Enterprise
-
HubSpot-krediittejä edellytetään tiettyjä ominaisuuksia varten
Synkronoi tiedot Google BigQuery -palvelusta HubSpot CRM -objekteihin, kuten yhteyshenkilöihin, yrityksiin, kauppoihin, liitoksiin ja muihin tilisi tietoihin.
Seuraavissa osioissa kerrotaan, miten valtuutat Google BigQuery -sovelluksen ja määrität synkronointiasetukset Google Cloud -tilisi ja HubSpotin välillä.
Käyttöoikeudet edellytetään Sinun on oltava HubSpot-tilisi pääkäyttäjä ( Super Admin ), jotta voit asentaa integraation.
Yhdistä ja määritä Google BigQuery -integraatio
Voit yhdistää Google BigQuery -tilisi HubSpot-tiliisi seuraavasti:
- Napsauta HubSpot-tilisi ylänavigointipalkin kauppakuvaketta
ja valitse HubSpot-kauppa. - Napsauta hakup alk kia ja kirjoita Google BigQuery.
- Napsauta luettelosivulta Google BigQuery .
- Napsauta Asenna.
- Napsauta Jatka asennusta.
Sinut ohjataan Data Integration -työkaluun, jossa sivupaneeli opastaa sinua synkronoimaan tietoja HubSpot- ja BigQuery-tiliesi välillä sen mukaan, mitkä tiedot haluat synkronoida:
- Google BigQuery → HubSpot: määritä synkronointi BigQuery-palvelusta HubSpot-palveluun.
- HubSpot → Google BigQuery: määritä synkronointi HubSpotista BigQueryyn.
Synkronoi Google BigQuery -tiedot HubSpot-tiliisi
HubSpot-krediittejä edellytetään tiettyjä ominaisuuksia varten Tietojen synkronointi suoraan yhdestä Data Studion tietovarastolähteestä HubSpot CRM:ään ei kuluta HubSpot-krediittejä. Jos valmistelet tietoja Data Studiossa ennen synkronointia (esimerkiksi luomalla laskettuja kenttiä tai yhdistämällä niitä muihin tietolähteisiin), nämä toimet kuluttavat HubSpot-krediittejä.
Voit lähettää Google BigQuery -tietoja HubSpot-palveluun lisäämällä ja määrittämällä uuden käyttäjän, jolla on tarvittavat roolit BigQuery-tililläsi:
- Valitse oikeanpuoleisesta ruudusta Google BigQuery → HubSpot.
- Kopioi HubSpotin luoma Google-palvelutilin sähköpostiosoite.
- Siirry Google Cloud -tililläsi projektisi IAM-asetuksiin, luo uusi käyttäjä käyttämällä HubSpotista kopioimaasi palvelutilin sähköpostiosoitetta ja lisää sitten vastaluodulle käyttäjälle roolit BigQuery Data Viewer ja BigQuery Job User.
- Kopioi projektitunnus Google Cloud -tililtäsi.
- Palaa HubSpotiin, liitä projektitunnus kenttään ja napsauta Testaa yhteys.
- Kun yhteys on vahvistettu, napsauta Seuraava ja viimeistele asetusten määrittäminen.
Synkronoi HubSpot-tiedot Google BigQuery -tiliisi
Voit lähettää HubSpot-tietoja Google BigQueryyn määrittämällä Google Cloud -tilillesi käyttäjän, jolla on tarvittavat käyttöoikeudet, sekä määrittämällä siihen liittyvän GCP-projektin ja GCS-säilytyspaikan URI-tunnisteen.
Huomaa: tarvitset Google Cloudin järjestelmänvalvojan käyttöoikeudet siihen GCP-projektiin, johon BigQuery-tietojoukko tallennetaan, sekä Google Cloud Storage (GCS) -säilytyspaikan, johon HubSpot tallentaa Parquet-tiedostot väliaikaisesti.
- Valitse oikeanpuoleisesta ruudusta HubSpot → Google BigQuery.
- Kopioi HubSpotin luoma Google-palvelutilin sähköpostiosoite.
- Siirry Google Cloud -tililläsi projektisi IAM-asetuksiin, luo uusi käyttäjä käyttämällä HubSpotista kopioimaasi palvelutilin sähköpostiosoitetta ja lisää sitten vastaluodulle käyttäjälle roolit BigQuery Data Viewer, BigQuery Job User ja Storage object owner.
- Kopioi projektitunnus Google Cloud -tililtäsi.
- Palaa HubSpotiin ja liitä projektit unnus.
- Lisää Google Cloud Storage (GCS) -säilön URI:
- GCS-säilön URI:n tulee noudattaa seuraavaa rakennetta:
gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/ - BigQuery-ulkoiset taulukot luodaan GCP-projektin erilliseen tietojoukkoon, ja niiden muoto on seuraava:
hubspot_data_set_{hubId} - Tiedot tallennetaan GCS-säilöön, ja niihin liittyvät taulukot viittaavat GCS:n parquet-tiedostoihin.
- Lisätietoja GCS-säilöjen luomisesta löytyy Googlen ohjeista.
- GCS-säilön URI:n tulee noudattaa seuraavaa rakennetta:
- Napsauta Testaa yhteys.
- Kun yhteys on vahvistettu, napsauta Seuraava.
- Valitse niiden tietolähteiden valintaruudut, jotka haluat synkronoida (esim. Yhteystiedot, Yhdistykset, Tapahtumat jne.).
- Määritä synkronointitiheys ja -aikataulu.
- Napsauta Aloita synkronointi.
Seuraa synkronointia
Kun olet määrittänyt tilien välisen synkronoinnin, voit tarkistaa synkronoinnin tilan ja historian synkronoinnin tietosivulta:
- Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Tietojen integraatio. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Tietojen integraatio.
- Napsauta Tuontien ja synkronointien seuranta-kohdassa Sovellusten synkronointi -välilehteä.
- Napsauta hakup alk kia ja hae Google BigQuery.
- Napsauta Google BigQuery. Huomaa, että tuloksia voi näkyä useita, jos olet määrittänyt synkronoinnin molempiin suuntiin.
- Synkronoinnin tietosivulla voit hallita ja tarkastella synkronointiasetuksiasi ja -historiaasi:
- Voit arkistoida tai muokata synkronointitietoja napsauttamalla oikeassa yläkulmassa Toiminnot ja valitsemalla sitten sopivan vaihtoehdon.
- Voit käynnistää synkronoinnin välittömästi napsauttamalla oikeassa yläkulmassa kohtaa Synkronoi nyt.
- Synkronoidut tietueet, liitännät ja virheet on koottu yhteen sivun yläosaan.
- Viimeaikaiset synkronointitoiminnot näkyvät taulukossa. Napsauta Synkronointihistoria- välilehteä tarkastellaksesi tiettyjä synkronointiyrityksiä ja -suorituksia. Voit suodattaa tuloksia tiettyjen päivämääräväleiden tai synkronointitilan mukaan.
Synkronointitilat ja virheiden käsittely
Alla olevassa taulukossa on esitetty mahdolliset synkronointitilat:
| Tila | Kuvaus |
| Synkronointi | Synkronointiyritys on parhaillaan käynnissä. |
| Synkronoitu | Viimeisin synkronointi suoritettiin onnistuneesti. |
| Epäonnistui | Viimeisimmässä synkronoinnissa ilmeni virhe. |
| Arkistoitu | Synkronointiasetukset on poistettu manuaalisesti, mutta niitä voi tarkastella myöhemmin. |
Jos synkronointi epäonnistuu:
- Synkronoinnin tietosivulle ilmestyy tila ”Epäonnistui” sekä tiedot siitä, minkä taulukoiden synkronointi onnistui ja minkä epäonnistui.
- Epäonnistumisen yhteydessä tietoja ei tallenneta osittain: BigQuery-taulukot päivittyvät vain, kun synkronointi on suoritettu onnistuneesti.
- Seuraava ajoitettu synkronointi yrittää automaattisesti suorittaa täyden synkronoinnin uudelleen.
- Voit käynnistää synkronoinnin uudelleen manuaalisesti milloin tahansa synkronoinnin tietosivulta.
Verkon sallittujen luettelo
HubSpot-tietojen synkronointi kolmannen osapuolen palveluntarjoajille, kuten BigQueryyn, reititetään HubSpotin välityspalvelimen IP-osoitteiden kautta. Näitä IP-osoitealueita käyttävät myös muut HubSpot-integraatiot, kuten tietojen synkronointi ja webhookit.
Jos organisaatiosi rajoittaa saapuvaa pääsyä GCP-resursseihisi, sinun tulee lisätä seuraavat CIDR-alueet sallittujen luetteloon HubSpot-hubletisi 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 |
Opi selvittämään, missä HubSpot-tilisi tiedot sijaitsevat.
Beta-version rajoitukset
Ota huomioon seuraavat rajoitukset tämän beta-version aikana:
- Synkronointitiheys: käytettävissä on vain rajoitettu joukko synkronointitiheyksiä, mukaan lukien kerran, 6 tunnin välein, 12 tunnin välein, päivittäin, viikoittain ja kuukausittain. Voit käynnistää synkronoinnin manuaalisesti milloin tahansa HubSpotin synkronointitietosivulta.
- Yksi vienti tietotyyppiä kohti: kukin objektityyppi, tapahtumatyyppi tai assosiaatiopari voidaan viedä vain yhdessä synkronointikokoonpanossa HubSpot-tiliä kohti.
- Esimerkiksi jos yhteystietoja viedään jo yhteen BigQuery-kohteeseen, niitä ei voi lisätä toiseen määritykseen, ennen kuin alkuperäinen kohde on arkistoitu.
- Tämä estää päällekkäiset dataputket ja varmistaa, että tietovarastossasi on yksi ainoa luotettava tietolähde kutakin tietotyyppiä kohden.
- Rajoitettu tuki arkaluonteisille tiedoille: voit tallentaa ja synkronoida arkaluonteisia tietoja HubSpot-tiliisi, mutta et voi synkronoida niitä BigQuery-tiliisi.
- object_x_views-tukea ei ole: object_x_views-objektia ei tällä hetkellä tueta synkronoinnissa BigQueryyn. Käytä
object_with_object_propertiestai yhdistäobjectsjaobject_propertiessaadaksesi vastaavat näkymät tietueittain.
Seuraavat vaiheet
Kun olet liittänyt BigQuery-integraation ja määrittänyt synkronointiasetukset, tutustu BigQuery-palvelussa synkronoitujen taulukoiden skeemaan.