Uwaga: Tłumaczenie tego artykułu jest podane wyłącznie dla wygody. Tłumaczenie jest tworzone automatycznie za pomocą oprogramowania tłumaczącego i mogło nie zostać sprawdzone. W związku z tym, angielska wersja tego artykułu powinna być uważana za wersję obowiązującą, zawierającą najnowsze informacje. Możesz uzyskać do niej dostęp tutaj.

Dostęp do danych HubSpot w Google BigQuery (wersja beta)

Data ostatniej aktualizacji: 30 czerwca 2026

Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:

Data Hub Enterprise

Po połączeniu Google BigQuery z kontem HubSpot możesz wyszukiwać dane HubSpot w BigQuery.

W tym artykule przedstawiono informacje na temat schematu każdej tabeli zsynchronizowanej z BigQuery, które można wykorzystać w połączeniu z dokumentacją Google do wyszukiwania danych HubSpot na koncie BigQuery.

Przegląd danych

Zapytania są tworzone przy użyciu języka SQL i mogą służyć do pobierania danych z HubSpot, takich jak:

Obiekty: obiekty standardowe i niestandardowe, takie jak kontakty, firmy, produkty.
Rekordy: pojedyncze rekordy, takie jak pojedynczy kontakt lub firma.
Powiązania: wszystkie dostępne typy powiązań oraz aktualnie powiązane rekordy.
Zdarzenia: dane dotyczące zarówno standardowych zdarzeń HubSpot, takich jak otwarcia wiadomości e-mail, jak i niestandardowych zdarzeń behawioralnych.

W wersji v1 dane obiektów różnych typów są łączone: wszystkie rekordy dla wszystkich typów obiektów są łączone w jeden obiekt bazy danych. Dlatego podczas wysyłania zapytania należy określić filtr, np. “WHERE objectTypeId=’0-1’

Obiektom niestandardowym zostanie przypisany identyfikator w momencie utworzenia i będą one identyfikowane jako 2-unique_ID. Na przykład 2-12345.

Dowiedz się więcej o modelu danych CRM HubSpot.

Schematy zsynchronizowanych tabel

Poniższe sekcje zawierają szczegółowe informacje na temat schematu każdej tabeli zsynchronizowanej z konta HubSpot do BigQuery, zgodnie ze skonfigurowanymi ustawieniami synchronizacji.

Schemat tabeli `object_properties`

Poniższy schemat zawiera szczegółowe informacje na temat zsynchronizowanej tabeli `object_properties`:

Nazwa kolumny	Typ	Opis
OBJECTTYPEID	STRING	Identyfikator typu obiektu (np. 0–1 dla kontaktów).
OBJECTID	INT64	Identyfikator rekordu (np. 123752 jako przykładowy rekord kontaktu).
NAME	STRING	Nazwa właściwości.
VALUE	JSON	Wartość właściwości
DATA AKTUALIZACJI	TIMESTAMP	Data i godzina ostatniej aktualizacji rekordu w HubSpot.
INGESTEDAT	TIMESTAMP	Data i godzina ostatniego zaimportowania rekordu do BigQuery.

Schemat „object_with_object_properties”

Poniższy schemat zawiera szczegółowe informacje na temat zsynchronizowanej tabeli object_with_object_properties:

Nazwa kolumny	Typ	Opis
OBJECTTYPEID	STRING	Identyfikator typu obiektu (np. 0–1 dla kontaktów).
OBJECTID	INT64	Identyfikator rekordu (np. 123752 jako przykładowy rekord kontaktu).
PROPERTIES	JSON	Wartości właściwości rekordu
UPDATEDAT	TIMESTAMP	Data i godzina ostatniej aktualizacji rekordu w HubSpot.
INGESTEDAT	TIMESTAMP	Data i godzina ostatniego zaimportowania rekordu do BigQuery.

Schemat „associations”

Poniższy schemat zawiera szczegółowe informacje na temat zsynchronizowanej tabeli associations:

Nazwa kolumny	Typ	Opis
COMBINEDASSOCIATIONTYPEID	STRING	Unikalny identyfikator definicji powiązania.
FROMOBJECTID	INT64	Identyfikator obiektu źródłowego.
TOOBJECTID	INT64	Identyfikator obiektu docelowego.
INGESTEDAT	TIMESTAMP	Data i godzina ostatniego zaimportowania rekordu do BigQuery.

Schemat „association_definitions”

Poniższy schemat zawiera szczegółowe informacje na temat zsynchronizowanej tabeli associations_definitions:

Nazwa kolumny	Typ	Opis
COMBINEDASSOCIATIONTYPEID	STRING	Unikalny identyfikator konkretnej definicji powiązania.
KATEGORIA POWIĄZANIA	STRING	Źródło typu powiązania. Możliwe wartości to: HUBSPOT_DEFINED, USER_DEFINED lub INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	CIĄG	Unikalny identyfikator definicji powiązania w ramach kategorii ASSOCIATIONCATEGORY. Żadne dwie definicje w tej samej kategorii nie będą miały tego samego identyfikatora.
FROMOBJECTTYPEID	STRING	Identyfikator typu obiektu będącego źródłem powiązania.
FROMOBJECTTYPE	STRING	Nazwa typu obiektu źródłowego powiązania.
TOOBJECTTYPEID	STRING	Identyfikator typu obiektu docelowego powiązania.
TOOBJECTTYPE	STRING	Nazwa typu obiektu docelowego powiązania.
NAME	STRING	Zdefiniowana nazwa definicji powiązania.
LABEL	STRING	Etykieta opisowa definicji powiązania.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Wskazuje, czy jest to główny typ powiązania (prawda), czyli ten, który HubSpot wyświetla w powiązanych rekordach.
INGESTEDAT	TIMESTAMP	Data i godzina ostatniego zaimportowania rekordu przez BigQuery.

Zdarzenia

Zdarzenia obejmują standardowe zdarzenia HubSpot oraz niestandardowe zdarzenia behawioralne. Każde zdarzenie ma swój własny obiekt w bazie danych, oznaczony jako events_eventname.

Nazwa
EVENTS_AD_INTERACTION	Szczegóły reklamy oraz dane kontaktowe osób, które weszły z nią w interakcję poprzez kliknięcie reklamy lub przesłanie formularza po nawiązaniu kontaktu z reklamą.
EVENTS_AD_METRICS_IMPORTED_V0	Szczegóły reklamy i wskaźniki jej skuteczności.
EVENTS_CALL_MENTIONED_KEYWORD	Szczegóły dotyczące słów kluczowych wymienionych przez dowolnych uczestników rozmów.
EVENTS_CALLED_LINK_IN_EMAIL_V2	Linki kliknięte przez kontakty w marketingowych wiadomościach e-mail.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Linki kliknięte przez kontakty w wiadomościach e-mail w skrzynce odbiorczej Conversations.
EVENTS_COOKIE_BANNER_CLICKED	Kontakty, które kliknęły baner dotyczący plików cookie.
EVENTS_COOKIE_BANNER_VIEWED	Kontakty, które wyświetliły informacje o plikach cookie.
EVENTS_DOCUMENT_SHARED_V2	Dokumenty sprzedażowe udostępnione kontaktom za pośrednictwem linku zewnętrznego.
EVENTS_DOCUMENT_VIEWED_V2	Dokumenty sprzedażowe oraz kontakty, które je wyświetliły, otwierając link zewnętrzny.
EVENTS_DOCUMENT_COMPLETED_V2	Dokumenty sprzedaży i kontakty, które je zamknęły.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-maile przesłane do serwerów pocztowych HubSpot w celu wysłania.
EVENTS_MTA_DELIVERED_EMAIL_V2	Wiadomości e-mail pomyślnie dostarczone do odbiorców przez serwery pocztowe HubSpot.
EVENTS_MTA_BOUNCED_EMAIL_V2	Próby dostarczenia wiadomości e-mail, które zostały odrzucone przez serwer pocztowy odbiorcy.
EVENTS_OPENED_EMAIL_V2	Otwarcia wiadomości e-mail przez kontakty.
EVENTS_REPORTED_SPAM_EMAIL_V2	Wiadomości e-mail oznaczone przez odbiorców jako spam.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Zmiany w subskrypcjach e-mailowych dokonane przez odbiorców.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Otwarcia wiadomości e-mail w skrzynce odbiorczej „Conservations” przez kontakty.
EVENTS_MB_MEDIA_PLAYED	Aktywność odtwarzania filmów przez kontakty.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt zarezerwował spotkanie za pośrednictwem sekwencji.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakt zapisał się do sekwencji.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekwencja została zakończona.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakt odpowiedział na wiadomość e-mail (lub na wiadomość przychodzącą, która spowodowała wyrejestrowanie z sekwencji) wysłaną w ramach sekwencji.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakt wyrejestrował się z sekwencji.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Użytkownik ręcznie wypisał kontakt.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakt zrezygnował z subskrypcji, co spowodowało wyrejestrowanie go z sekwencji.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	E-mail z sekwencji został odrzucony.
EVENTS_V2_SEQUENCE_ERRORED	Wystąpił błąd sekwencji, co spowodowało wyrejestrowanie.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Wykonano krok sekwencji.
EVENTS_VISITED_PAGE	Odwiedziny stron internetowych przez kontakty.
EVENTS_<NAZWA_ZDARZENIA_INTEGRACYJNEGO>_<UNIKALNY_IDENTYFIKATOR>	Zdarzenia integracyjne (API Timeline V3)

Zdarzenia można zidentyfikować, łącząc ich identyfikator typu zdarzenia z identyfikatorem. Kolumny, które są zwracane, zależą od zdarzenia, przy czym dla każdej właściwości zdarzenia jest jedna kolumna. Wszystkie zdarzenia zwracają następujące kolumny:

Nazwa kolumny	Typ	Opis
`EVENTTYPEID`	STRING	Identyfikator typu zdarzenia, podobny do OBJECTTYPEID Możesz wyszukać wszystkie identyfikatory typów zdarzeń na swoim koncie, korzystając z widoku object_and_event_type_definitions.
`ID`	STRING	Jest to identyfikator unikalny dla każdego typu zdarzenia. W obrębie danego typu zdarzenia nie ma dwóch rekordów o tym samym identyfikatorze.
`OBJECTTYPEID`	STRING	Typ obiektu, który spowodował zdarzenie. Na przykład kliknięcie linku w wiadomości e-mail spowoduje wyświetlenie w tej kolumnie`0-1`, co oznacza obiekt „kontakty”.
`OBJECTID`	INT64	Identyfikator rekordu, który zrealizował zdarzenie.
`OCCURREDAT`	TIMESTAMP	Czas wystąpienia zdarzenia.
`OCCURREDATDATEINT`	INT64	Liczba określająca moment wystąpienia zdarzenia. Zawiera te same dane co kolumna `OCCURREDAT`, ale jest sformatowana jako liczba i wykorzystywana jako część klucza klastrowego tabeli. W większości przypadków zamiast tej liczby można użyć znacznika czasu `OCCURREDAT`.
`OCCUREDATDATEINT`	Liczba	Liczba określająca moment wystąpienia zdarzenia. Zawiera te same dane co kolumna `OCCURREDAT`, ale ma format liczbowy i jest wykorzystywana jako część klucza klastrowego tabeli. W większości przypadków zamiast tej liczby można użyć znacznika czasu `OCCURREDAT`.
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego załadowania danych do BigQuery. Dowiedz się więcej o typach danych kolumn.
`PROPERTY_*`	Varchar	Poszczególne kolumny zawierające właściwości zdarzeń.

Czy ten artykuł okazał się pomocny?

Niniejszy formularz służy wyłącznie do przekazywania opinii dotyczących dokumentacji. Dowiedz się, jak uzyskać pomoc dotyczącą HubSpot.

Wersja betaDostęp do danych HubSpot w Google BigQuery (wersja beta)