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 (BETA)

Data ostatniej aktualizacji: 1 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 znajdziesz informacje na temat schematu każdej tabeli zsynchronizowanej z BigQuery, które możesz wykorzystać w połączeniu z dokumentacją Google, aby wyszukiwać dane HubSpot na swoim koncie BigQuery.

Przegląd danych

Zapytania są tworzone przy użyciu języka SQL i mogą służyć do pobierania danych 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ń i aktualnie powiązane rekordy.
Zdarzenia: dane zdarzeń zarówno dla standardowych zdarzeń HubSpot, takich jak otwarcia wiadomości e-mail, jak i niestandardowych zdarzeń behawioralnych.

Dane obiektów różnych typów są łączone w wersji v1: 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’

Obiekty niestandardowe otrzymają identyfikator w momencie utworzenia i będą 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, w oparciu o skonfigurowane ustawienia synchronizacji.

Schemat 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 przez 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
DATA AKTUALIZACJI	TIMESTAMP	Data i godzina ostatniej aktualizacji rekordu w HubSpot.
INGESTEDAT	TIMESTAMP	Data i godzina ostatniego zaimportowania rekordu przez BigQuery.

Schemat associations_x_to_y

Poniższy schemat zawiera szczegóły dotyczące zsynchronizowanej tabeli associations_x_to_y_:

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	STRING	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 źródłowego 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 (true), czyli ten, który HubSpot wyświetla w powiązanych rekordach.
[FROMOBJECTTYPE_OBJECTID]	INT64	Identyfikator obiektu rekordu źródłowego. (np. CONTACT_OBJECTID dla widoku ASSOCIATIONS_CONTACTS_TO_DEALS).
[TOOBJECTTYPE_OBJECTID]	INT64	Identyfikator obiektu rekordu docelowego. (np. DEAL_OBJECTID dla widoku ASSOCIATIONS_CONTACTS_TO_DEALS).
INGESTEDAT	TIMESTAMP	Data i godzina ostatniego załadowania rekordu do BigQuery.

Schemat associations

Poniższy schemat zawiera szczegóły dotyczące 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 załadowania rekordu do BigQuery.

schemat association_definitions

Poniższy schemat zawiera szczegóły dotyczące 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	STRING	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 źródłowego 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 (true), 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 kontaktów, które weszły z nią w interakcję poprzez kliknięcie reklamy lub przesłanie formularza po nawiązaniu kontaktu.
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_CLICKED_LINK_IN_EMAIL_V2	Linki kliknięte w marketingowych wiadomościach e-mail przez kontakty.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Linki kliknięte w wiadomościach e-mail w skrzynce odbiorczej Conversations przez kontakty.
EVENTS_COOKIE_BANNER_CLICKED	Kontakty, które kliknęły pliki cookie.
EVENTS_COOKIE_BANNER_VIEWED	Kontakty, które wyświetliły pliki cookie.
EVENTS_DOCUMENT_SHARED_V2	Dokumenty sprzedaży udostępnione kontaktom za pośrednictwem linku zewnętrznego.
EVENTS_DOCUMENT_VIEWED_V2	Dokumenty sprzedaży i 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	E-maile 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	E-maile oznaczone jako spam przez odbiorców.
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 przez kontakty.
EVENTS_MB_MEDIA_PLAYED	Aktywność odtwarzania wideo według kontaktów.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt zarezerwował spotkanie poprzez sekwencję.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakt zapisał się do sekwencji.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekwencja zakończona.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakt odpowiedział na wiadomość e-mail (lub przychodzącą wiadomość e-mail, 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, wypisując się 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_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Zdarzenia integracji (API Timeline V3)

Zdarzenia można zidentyfikować, łącząc ich identyfikator typu zdarzenia i identyfikator. Kolumny, które są zwracane, zależą od zdarzenia, przy czym jedna kolumna odpowiada każdej właściwości zdarzenia. 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 on unikalny dla każdego typu zdarzenia. W ramach danego typu zdarzenia nie ma dwóch rekordów o tym samym identyfikatorze.
`OBJECTTYPEID`	STRING	Typ obiektu, który zrealizował zdarzenie. Na przykład kliknięcie linku w wiadomości e-mail spowoduje wyświetlenie w tej kolumnie`0-1`, reprezentującej obiekt kontaktów.
`OBJECTID`	INT64	Identyfikator rekordu, który zrealizował zdarzenie.
`OCCURREDAT`	TIMESTAMP	Kiedy wystąpiło zdarzenie.
`OCCURREDATDATEINT`	INT64	Liczba reprezentująca moment wystąpienia zdarzenia. Zawiera te same dane co kolumna `OCCURREDAT`, ale sformatowana jest jako liczba i służy jako część klucza klastrowego tabeli. W większości przypadków zamiast tej liczby można użyć znacznika czasu `OCCURREDAT`.
`OCCUREDATDATEINT`	Liczba	Liczba reprezentująca moment wystąpienia zdarzenia. Zawiera te same dane co kolumna `OCCURREDAT`, ale ma format liczby i jest używana 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 zdarzenia.

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 (BETA)