Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt.

HubSpot-Daten in Google BigQuery aufrufen (BETA)

Zuletzt aktualisiert am: 1 Juni 2026

Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):

Data Hub Enterprise

Nachdem Sie Google BigQuery mit Ihrem HubSpot-Account verknüpft haben, können Sie in BigQuery HubSpot-Daten abfragen.

Dieser Artikel enthält Informationen zum Schema für jede mit BigQuery synchronisierte Tabelle, die Sie zusammen mit der Google-Dokumentation verwenden können, um HubSpot-Daten in Ihrem BigQuery-Account abzufragen.

Datenüberblick

Abfragen werden mit SQL erstellt und können zum Abrufen von HubSpot-Daten wie z. B.:

Objekte: Standard- und benutzerdefinierte Objekte, wie Kontakte, Unternehmen, Produkte.
Datensätze: einzelne Datensätze, z. B. ein einzelner Kontakt oder ein Unternehmen.
Zuordnungen: alle verfügbaren Zuordnungen und die aktuell verknüpften Datensätze.
Ereignisse: Ereignisdaten sowohl für standardmäßige HubSpot-Ereignisse, wie z. B. das Öffnen von E-Mails, als auch für benutzerdefinierte verhaltensbezogene Ereignisse.

Für v1 werden Objektdaten unterschiedlicher Art kombiniert: Alle Datensätze aller Objekttypen werden in einem Datenbankobjekt zusammengefasst. Daher müssen Sie beim Abfragen einen Filter wie “WHERE objectTypeId=’0-1’angeben.

Benutzerdefinierten Objekten wird zum Zeitpunkt der Erstellung eine ID zugewiesen und sie werden als 2-unique_IDidentifiziert. Zum Beispiel 2-12345.

Erfahren Sie mehr über das CRM-System von HubSpot.

Synchronisierte Tabellenschemata

Die folgenden Abschnitte enthalten Details zum Schema für jede Tabelle, die von Ihrem HubSpot-Account mit BigQuery synchronisiert wird, basierend auf Ihren konfigurierten Synchronisierungseinstellungen.

object_properties Schema

Das folgende Schema enthält Details zur synchronisierten object_properties Tabelle:

Spaltenname	Typ	Beschreibung
OBJECTTYPEID	SCHNUR	Die ID des Objekttyps (z. B. 0-1 für Kontakte).
OBJECTID	INT64	Die ID des Datensatzes (z. B. 123752 als Beispiel Kontaktdatensatz ).
NAME	SCHNUR	Der Name der Eigenschaft.
VALUE	JSON	Der Wert der Eigenschaft
UPDATEDAT	TIMESTAMP	Der Zeitpunkt (Datum und Uhrzeit), zu dem der Datensatz zuletzt in HubSpot aktualisiert wurde.
INGESTEDAT	TIMESTAMP	Das Datum und die Uhrzeit, zu der der Datensatz zuletzt von BigQuery erfasst wurde.

object_with_object_properties Schema

Das folgende Schema enthält Details der synchronisierten object_with_object_properties Tabelle:

Spaltenname	Typ	Beschreibung
OBJECTTYPEID	SCHNUR	Die ID des Objekttyps (z. B. 0-1 für Kontakte).
OBJECTID	INT64	Die ID des Datensatzes (z. B. 123752 als Beispiel Kontaktdatensatz ).
PROPERTIES	JSON	Die Eigenschaften des Datensatzes
UPDATEDAT	TIMESTAMP	Der Zeitpunkt (Datum und Uhrzeit), zu dem der Datensatz zuletzt in HubSpot aktualisiert wurde.
INGESTEDAT	TIMESTAMP	Das Datum und die Uhrzeit, zu der der Datensatz zuletzt von BigQuery erfasst wurde.

associations_x_to_y Schema

Das folgende Schema enthält Details zur synchronisierten associations_x_to_y_ Tabelle:

Spaltenname	Typ	Beschreibung
COMBINEDASSOCIATIONTYPEID	SCHNUR	Die eindeutige ID für die spezifische Zuordnung Definition.
VERBANDSKATEGORIE	SCHNUR	Der Ursprung des Zuordnungstyps. Mögliche Werte sind: HUBSPOT_DEFINED, USER_DEFINED oder INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	SCHNUR	Eine eindeutige ID für eine Zuordnung Definition innerhalb ihrer ASSOCIATIONCATEGORY. Keine zwei Definitionen in derselben Kategorie teilen diese ID.
FROMOBJECTTYPEID	SCHNUR	Die Objekttyp-ID des Quellobjekts der Zuordnung.
FROMOBJECTTYPE	SCHNUR	Der Name des Quell-Objekttyps der Zuordnung.
TOOBJECTTYPEID	SCHNUR	Die Objekttyp-ID des Zielobjekts der Zuordnung.
TOOBJECTTYPE	SCHNUR	Der Name des Ziel-Objekttyps der Zuordnung.
NAME	SCHNUR	Der definierte Name der Zuordnung Definition.
LABEL	SCHNUR	Eine beschreibende Bezeichnung für die Zuordnung Definition
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Gibt an, ob dies der primäre Zuordnung Typ ist (true), also den, den HubSpot in den zugehörigen Datensätzen anzeigt.
[FROMOBJECTTYPE_OBJECTID]	INT64	Die Objekt-ID des Quelldatensatzes. (z. B. CONTACT_OBJECTID für eine ASSOCIATIONS_CONTACTS_TO_DEALS Ansicht).
[TOOBJECTTYPE_OBJECTID]	INT64	Die Objekt-ID des Zieldatensatzes. (z. B. DEAL_OBJECTID für eine ASSOCIATIONS_CONTACTS_TO_DEALS Ansicht).
INGESTEDAT	TIMESTAMP	Das Datum und die Uhrzeit, zu der der Datensatz zuletzt von BigQuery erfasst wurde.

Zuordnungsschema

Das folgende Schema enthält Details zur Tabelle synchronisierter Zuordnungen:

Spaltenname	Typ	Beschreibung
COMBINEDASSOCIATIONTYPEID	SCHNUR	Die eindeutige ID der Zuordnungsdefinition.
FROMOBJECTID	INT64	Die ID des Quellobjekts.
TOOBJECTID	INT64	Die ID des Zielobjekts.
INGESTEDAT	TIMESTAMP	Das Datum und die Uhrzeit, zu der der Datensatz zuletzt von BigQuery erfasst wurde.

association_definitions Schema

Das folgende Schema enthält Details der synchronisierten associations_definitions Tabelle:

Spaltenname	Typ	Beschreibung
COMBINEDASSOCIATIONTYPEID	SCHNUR	Die eindeutige ID für die spezifische Zuordnung Definition.
VERBANDSKATEGORIE	SCHNUR	Der Ursprung des Zuordnungstyps. Mögliche Werte sind: HUBSPOT_DEFINED, USER_DEFINED oder INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	SCHNUR	Eine eindeutige ID für eine Zuordnung Definition innerhalb ihrer ASSOCIATIONCATEGORY. Keine zwei Definitionen in derselben Kategorie teilen diese ID.
FROMOBJECTTYPEID	SCHNUR	Die Objekttyp-ID des Quellobjekts der Zuordnung.
FROMOBJECTTYPE	SCHNUR	Der Name des Quell-Objekttyps der Zuordnung.
TOOBJECTTYPEID	SCHNUR	Die Objekttyp-ID des Zielobjekts der Zuordnung.
TOOBJECTTYPE	SCHNUR	Der Name des Ziel-Objekttyps der Zuordnung.
NAME	SCHNUR	Der definierte Name der Zuordnung Definition.
LABEL	SCHNUR	Eine beschreibende Bezeichnung für die Zuordnung Definition
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Gibt an, ob dies der primäre Zuordnung Typ ist (true), also den, den HubSpot in den zugehörigen Datensätzen anzeigt.
INGESTEDAT	TIMESTAMP	Das Datum und die Uhrzeit, zu der der Datensatz zuletzt von BigQuery erfasst wurde.

Events

Events umfassen standardmäßige HubSpot-Events und benutzerdefinierte verhaltensorientierte Events. Jedes Ereignis hat sein eigenes Datenbankobjekt mit der Bezeichnung events_eventname.

Vor- und Nachname
EREIGNISSE_ANZEIGE_INTERAKTION	Details zu einer Anzeige und den Kontakten, die mit der Anzeige interagiert haben, indem sie auf die Anzeige geklickt oder ein Formular ausgefüllt haben, nachdem sie mit der Anzeige in Kontakt gekommen sind.
EVENTS_AD_METRICS_IMPORTED_V0	Details zu einer Anzeige und deren Leistungskennzahlen.
EREIGNIS_AUFRUF_ERWÄHNT_SCHLÜSSELWORT	Einzelheiten zu den von den Gesprächsteilnehmern genannten Schlüsselwörtern.
EREIGNISSE_GEKLICKT_LINK_IN_EMAIL_V2	Von Kontakten angeklickte Links in Marketing-E-Mails.
EREIGNISSE_GEKLICKTER_LINK_IM_VERFOLGTEN_POSTEINGANG_EMAIL_V8	Von Kontakten angeklickte Links in Posteingangs-E-Mails von Konversationen.
EVENTS_COOKIE_BANNER_GEKLICKT	Kontakte, die auf Cookies geklickt haben.
EVENTS_COOKIE_BANNER_VIEWED	Kontakte, die Cookies angesehen haben.
EREIGNISSE_DOKUMENTE_GEMEINSAM_V2	Verkaufsdokumente, die mit Kontakten über einen externen Link geteilt werden.
EREIGNISSE_DOKUMENTE_ANGESEHEN_V2	Verkaufsdokumente und Kontakte, die sie durch Öffnen des externen Links aufgerufen haben.
EREIGNISSE_DOKUMENTE_ERLEDIGT_V2	Verkaufsdokumente und Kontakte, die sie abgeschlossen haben.
EREIGNISSE_HS_GEPLANTE_EMAIL_V2	E-Mails, die zum Versand an die HubSpot-E-Mail-Server übermittelt werden.
EREIGNISSE_MTA_ABGELIEFERTE_EMAIL_V2	E-Mails, die von den HubSpot-E-Mail-Servern erfolgreich an die Empfänger zugestellt wurden.
EREIGNISSE_MTA_GEPRELLT_EMAIL_V2	E-Mail-Zustellversuche, die vom E-Mail-Server des Empfängers abgelehnt wurden.
EREIGNISSE_GEÖFFNETE_EMAIL_V2	E-Mail-Öffnungen durch Kontakte.
EREIGNISSE_GEMELDETER_SPAM_EMAIL_V2	E-Mails, die von Empfängern als Spam markiert wurden.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Änderungen an E-Mail-Abonnements durch die Empfänger.
EREIGNISSE_GEÖFFNETE_VERFOLGTE_POSTEINGANG_EMAIL_V8	Öffnungen von E-Mails im Posteingang nach Kontakten.
EREIGNISSE_MB_MEDIA_ABGESPIELT	Aktivität der Videowiedergabe nach Kontakten.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt buchte ein Treffen über Sequence.
EREIGNISSE_V2_KONTAKT_EINGESCHRIEBEN_IN_REIHENFOLGE	Kontakt eingeschrieben von Sequenz.
EREIGNISSE_V2_KONTAKT_BEENDET_SEQUENZ	Sequenz beendet.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Der Kontakt hat auf eine E-Mail geantwortet (oder eine eingehende E-Mail, die eine Sequenz ausgelöst hat), die über die Sequenz gesendet wurde.
EVENTS_V2_CONTACT_UNROLLED_FROM_SEQUENCE	Kontakt wird aus der Sequenz entfernt.
EVENTS_V2_CONTACT_UNROLLED_MANUALLY_FROM_SEQUENCE	Der Benutzer hat die Registrierung des Kontakts manuell aufgehoben.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Der Kontakt hat sich abgemeldet und die Sequenz abbestellt.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sequenz-E-Mail gebounct.
EVENTS_V2_SEQUENCE_ERRORED	Fehlerhafte Sequenz führt zur Abmeldung.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sequenzschritt ausgeführt.
EREIGNISSE_BESUCHT_SEITE	Website-Besuche nach Kontakten.
VERANSTALTUNGEN_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationsevents (Chronik V3 API )

Sie können Events identifizieren, indem Sie ihre Event-Typ-ID und ID kombinieren. Die Spalten, die zurückgegeben werden, hängen vom Event ab, mit einer Spalte für jede Event-Eigenschaft. Alle Events geben die folgenden Spalten zurück:

Spaltenname	Typ	Beschreibung
`EVENTTYPEID`	SCHNUR	Die ID des Ereignistyps, ähnlich wie OBJECTTYPEID Sie können alle Ereignistyp-IDs in Ihrem Konto mit der Ansicht object_and_event_type_definitions abfragen.
`ID`	SCHNUR	Dies ist für jeden Veranstaltungstyp einzigartig. Innerhalb eines bestimmten Ereignistyps haben keine zwei Datensätze die gleiche ID.
`OBJECTTYPEID`	SCHNUR	Der Typ des Objekts, das das Event abgeschlossen hat. Ein Klick auf einen E-Mail-Link würde zum Beispiel `0-1` in dieser Spalte angezeigt, die das Kontaktobjekt darstellt.
`OBJECTID`	INT64	Die ID des Datensatzes, der das Event abgeschlossen hat.
`OCCURREDAT`	TIMESTAMP	Wann das Event aufgetreten ist.
`OCCURREDATDATEINT`	INT64	Eine Zahl, die angibt, wann das Event aufgetreten ist. Enthält die gleichen Daten wie die Spalte `OCCURREDAT` spalte, jedoch als Zahl formatiert und als Teil des Clusterschlüssels der Tabelle verwendet. In den meisten Fällen können Sie den `OCCURREDAT` zeitstempel anstelle dieser Zahl verwenden.
`OCCUREDATDATEINT`	Zahl	Eine Zahl, die angibt, wann das Event aufgetreten ist. Enthält die gleichen Daten wie die Spalte `OCCURREDAT` spalte, jedoch als Zahl formatiert und als Teil des Clusterschlüssels der Tabelle verwendet. In den meisten Fällen können Sie den `OCCURREDAT` zeitstempel anstelle dieser Zahl verwenden.
`INGESTEDAT`	Zeitstempel	Das Datum und die Uhrzeit, zu der die Daten zuletzt von BigQuery erfasst wurden. Erfahren Sie mehr über Spaltendatentypen.
`PROPERTY_*`	Varchar	Einzelne Spalten, die die Event-Eigenschaften enthalten.

War dieser Artikel hilfreich?

Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.

BetaHubSpot-Daten in Google BigQuery aufrufen (BETA)