Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties.

Accéder aux données HubSpot dans Google BigQuery (bêta)

Dernière mise à jour: 1 juin 2026

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Data Hub Enterprise

Après avoir connecté Google BigQuery à votre compte HubSpot, vous pouvez interroger les données HubSpot dans BigQuery.

Cet article fournit des informations sur le schéma de chaque table synchronisée avec BigQuery, que vous pouvez utiliser en tandem avec la documentation de Google pour interroger les données HubSpot dans votre compte BigQuery.

Présentation des données

Les requêtes sont construites en utilisant SQL, et peuvent être utilisées pour récupérer des données HubSpot telles que :

Objets: objets standard et personnalisés, tels que les contacts, les entreprises et les produits.
Enregistrements: enregistrements individuels, tels qu'un contact individuel ou une entreprise.
Associations : tous les types d’association disponibles et les fiches d’informations actuellement associées.
E-mails: données d'événements pour les événements HubSpot standard, tels que les ouvertures d'e-mails, et les événements comportementaux personnalisés.

Les données d’objets de différents types sont combinées pour v1 : toutes les fiches d’informations de tous les types d’objets sont combinées en un seul objet de base de données. Ainsi, lors de l’interrogation, vous devez spécifier un filtre comme “WHERE objectTypeId=’0-1’.

Un ID sera attribué aux objets personnalisés au moment de leur création et sera identifié comme . 2-unique_ID Par exemple, 2-12345.

Découvrez-en davantage sur le modèle de données CRM de HubSpot.

Schémas de tableaux synchronisés

Les sections ci-dessous fournissent des détails sur le schéma de chaque tableau synchronisé de votre compte HubSpot vers BigQuery, en fonction des paramètres de synchronisation configurés.

object_properties schéma

Le schéma ci-dessous fournit des détails sur le tableau de object_properties synchronisé :

Nom de la colonne	Type	Description
OBJECTTYPEID	STRING	L’ID du type d’objet (par exemple, 0-1 pour les contacts).
OBJECTID	INT64	L’ID de la fiche d’informations (par exemple, 123752 à titre d’exemple fiche d'informations d'un contact ).
NOM	STRING	Le nom de la propriété.
VALUE	JSON	La valeur de la propriété
UPDATEDAT	TIMESTAMP	La date et l'heure de la dernière mise à jour de la fiche d'informations dans HubSpot.
INGESTEDAT	TIMESTAMP	La date et l’heure auxquelles la fiche d’informations a été ingérée pour la dernière fois par BigQuery.

object_with_object_properties schéma

Le schéma ci-dessous fournit des détails sur le tableau de object_with_object_properties synchronisé :

Nom de la colonne	Type	Description
OBJECTTYPEID	STRING	L’ID du type d’objet (par exemple, 0-1 pour les contacts).
OBJECTID	INT64	L’ID de la fiche d’informations (par exemple, 123752 à titre d’exemple fiche d'informations d'un contact ).
PROPERTIES	JSON	Les valeurs de propriété de la fiche d’informations
UPDATEDAT	TIMESTAMP	La date et l'heure de la dernière mise à jour de la fiche d'informations dans HubSpot.
INGESTEDAT	TIMESTAMP	La date et l’heure auxquelles la fiche d’informations a été ingérée pour la dernière fois par BigQuery.

associations_x_to_y schéma

Le schéma ci-dessous fournit des détails sur le tableau de associations_x_to_y_ synchronisé :

Nom de la colonne	Type	Description
COMBINEDASSOCIATIONTYPEID	STRING	L’identifiant unique de la définition d’association spécifique.
CATÉGORIE D'ASSOCIATION	STRING	L’origine du type d’association. Les valeurs possibles sont HUBSPOT_DEFINED, USER_DEFINED ou INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	STRING	Un identifiant unique pour une définition d’association dans sa catégorie ASSOCIATION. Aucune des définitions de la même catégorie ne partagera cet ID.
FROMOBJECTTYPEID	STRING	L’ID du type d’objet de l’objet source de l’association.
À PARTIR DU TYPE D'OBJET	STRING	Le nom du type d’objet source de l’association.
TOOBJECTTYPEID	STRING	L’ID du type d’objet de l’objet de destination de l’association.
TOOBJECTTYPE	STRING	Le nom du type d’objet de destination de l’association.
NOM	STRING	Le nom défini de la définition d’association.
LABEL	STRING	Un libellé descriptif pour la définition d’association.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Indique s’il s’agit du type d’association principal (true), c’est-à-dire celui que HubSpot affiche sur les fiches d’informations associées.
[FROMOBJECTTYPE_OBJECTID]	INT64	L’ID d’objet de la fiche d’informations source. (par exemple, CONTACT_OBJECTID pour une vue ASSOCIATIONS_CONTACTS_TO_DEALS).
[TOOBJECTTYPE_OBJECTID]	INT64	L’ID d’objet de la fiche d’informations de destination. (par exemple, DEAL_OBJECTID pour une vue ASSOCIATIONS_CONTACTS_TO_DEALS).
INGESTEDAT	TIMESTAMP	La date et l’heure auxquelles la fiche d’informations a été ingérée pour la dernière fois par BigQuery.

schéma d’association

Le schéma ci-dessous fournit des détails sur le tableau des associations synchronisées :

Nom de la colonne	Type	Description
COMBINEDASSOCIATIONTYPEID	STRING	L'identifiant unique de la définition d'association.
FROMOBJECTID	INT64	L'ID de l'objet source.
TOOBJECTID	INT64	L'ID de l'objet de destination.
INGESTEDAT	TIMESTAMP	La date et l’heure auxquelles la fiche d’informations a été ingérée pour la dernière fois par BigQuery.

association_definitions schéma

Le schéma ci-dessous fournit des détails sur le tableau de associations_definitions synchronisé :

Nom de la colonne	Type	Description
COMBINEDASSOCIATIONTYPEID	STRING	L’identifiant unique de la définition d’association spécifique.
CATÉGORIE D'ASSOCIATION	STRING	L’origine du type d’association. Les valeurs possibles sont HUBSPOT_DEFINED, USER_DEFINED ou INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	STRING	Un identifiant unique pour une définition d’association dans sa catégorie ASSOCIATION. Aucune des définitions de la même catégorie ne partagera cet ID.
FROMOBJECTTYPEID	STRING	L’ID du type d’objet de l’objet source de l’association.
À PARTIR DU TYPE D'OBJET	STRING	Le nom du type d’objet source de l’association.
TOOBJECTTYPEID	STRING	L’ID du type d’objet de l’objet de destination de l’association.
TOOBJECTTYPE	STRING	Le nom du type d’objet de destination de l’association.
NOM	STRING	Le nom défini de la définition d’association.
LABEL	STRING	Un libellé descriptif pour la définition d’association.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Indique s’il s’agit du type d’association principal (true), c’est-à-dire celui que HubSpot affiche sur les fiches d’informations associées.
INGESTEDAT	TIMESTAMP	La date et l’heure auxquelles la fiche d’informations a été ingérée pour la dernière fois par BigQuery.

Événements

Les événements comprennent les événements standards de HubSpot ainsi que des événements comportementaux personnalisés. Chaque événement possède son propre objet de base de données, libellé comme suit events_eventname.

Nom
ÉVÉNEMENTS_AD_INTERACTION	Détails d'une annonce et des contacts qui ont interagi avec elle en cliquant sur l'annonce ou en soumettant un formulaire après y avoir participé.
ÉVÉNEMENTS_AD_METRICS_IMPORTED_V0	Détails d'une annonce et de ses mesures de performance.
APPEL_ÉVÉNEMENTS_MOT_CLÉ MENTIONNÉ	Détails des mots-clés mentionnés par tous les participants aux appels.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Liens cliqués par les contacts dans les e-mails de marketing.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Liens cliqués dans les e-mails de la boîte de réception des conversations par les contacts.
ÉVÉNEMENTS_COOKIE_BANNER_CLICKED	Contacts qui ont cliqué sur les cookies.
ÉVÉNEMENTS_COOKIE_BANNER_VIEWED	Contacts qui ont consulté les cookies.
ÉVÉNEMENTS_DOCUMENT_PARTAGÉS_V2	Documents de vente partagés avec les contacts via un lien externe.
ÉVÉNEMENTS_DOCUMENT_VIEWED_V2	Documents de vente et contacts qu'ils ont consultés en ouvrant le lien externe.
ÉVÉNEMENTS_DOCUMENT_COMPLÉTÉ_V2	Documents de vente et contacts qui les ont clôturés.
ÉVÉNEMENTS_HS_SCHEDULED_EMAIL_V2	Les e-mails soumis aux serveurs de messagerie de HubSpot pour être envoyés.
ÉVÉNEMENTS_MTA_MAIL_DÉLIVRÉ_V2	Emails délivrés avec succès aux destinataires par les serveurs de messagerie HubSpot.
EVENTS_MTA_BOUNCED_EMAIL_V2	Tentatives de livraison d'e-mails qui ont été rejetées par le serveur de messagerie du destinataire.
ÉVÉNEMENTS_OUVERTS_EMAIL_V2	Ouverture des e-mails par les contacts.
ÉVÉNEMENTS_REPORTÉS_SPAM_EMAIL_V2	Emails marqués comme spam par les destinataires.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Modifications des abonnements aux e-mails par les destinataires.
ÉVÉNEMENTS_OUVERTS_TRAÇÉS_BOÎTE_EMAIL_V8	Ouverture de la boîte de réception des conservations par les contacts.
ÉVÉNEMENTS_MB_MEDIA_PLAYED	Activité de lecture vidéo par contacts.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Le contact a réservé une réunion par le biais de la séquence.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Contact inscrit à partir de la séquence.
ÉVÉNEMENTS_V2_CONTACT_FINISHED_SEQUENCE	Séquence terminée.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Le contact a répondu à l'e-mail (ou à l'e-mail entrant qui a désinscrit la séquence) envoyé par la séquence.
ÉVÉNEMENTS_V2_CONTACT_NON INSCRITS_DE_LA_SÉQUENCE	Contact non inscrit dans la séquence.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	L'utilisateur a manuellement désinscrit le contact.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Le contact s'est désinscrit, désinscrivant la séquence.
ÉVÉNEMENTS_V2_SÉQUENCE_EMAIL_ANNONCÉ	L'email de la séquence a rebondi.
ÉVÉNEMENTS_V2_SÉQUENCE_ERRORED	Séquence erronée causant une désinscription.
ÉVÉNEMENTS_V2_SÉQUENCE_ÉTAPE_EXÉCUTÉE	Étape de la séquence exécutée.
ÉVÉNEMENTS_VISITÉS_PAGE	Visites de pages du site web par les contacts.
EVENEMENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Événements d’intégration (API Chronologie V3)

Vous pouvez identifier les événements en combinant leur ID de type d'événement et leur ID. Les colonnes qui sont retournées dépendent de l'événement, avec une colonne pour chaque propriété d'événement. Tous les événements renverront les colonnes suivantes :

Nom de la colonne	Type	Description
`EVENTTYPEID`	STRING	L'ID du type d'événement, similaire à OBJECTTYPEID Vous pouvez interroger tous les ID des types d'événements dans votre compte en utilisant la vue object_and_event_type_definitions.
`ID`	STRING	Ceci est unique par type d'événement. Il n'y aura pas deux enregistrements ayant le même ID pour un type d'événement donné.
`OBJECTTYPEID`	STRING	Le type d'objet qui a réalisé l'événement. Par exemple, un clic sur un lien d'e-mail affichera `0-1` dans cette colonne, représentant l'objet contacts.
`OBJECTID`	INT64	L'ID de la fiche d'informations qui a terminé l'événement.
`OCCURREDAT`	TIMESTAMP	Date à laquelle l'événement s'est produit.
`OCCURREDATDATEINT`	INT64	Un nombre représentant la date à laquelle l'événement s'est produit. Contient les mêmes données que la colonne `OCCURREDAT` mais formatées sous forme de nombre et utilisées comme partie de la clé de cluster de la table. Dans la plupart des cas, vous pouvez utiliser l'horodatage `OCCURREDAT` au lieu de ce nombre.
`OCCUREDATDATEINT`	Numéro	Un nombre représentant la date à laquelle l'événement s'est produit. Contient les mêmes données que la colonne `OCCURREDAT` mais formatées sous forme de nombre et utilisées comme partie de la clé de cluster de la table. Dans la plupart des cas, vous pouvez utiliser l'horodatage `OCCURREDAT` au lieu de ce nombre.
`INGESTEDAT`	Horodatage	La date et l’heure auxquelles les données ont été ingérées pour la dernière fois par BigQuery. Découvrez-en davantage sur les types de données des colonnes.
`PROPERTY_*`	Varchar	Colonnes individuelles contenant les propriétés de l'événement.

Cet article vous a-t-il été utile ?

Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.

BêtaAccéder aux données HubSpot dans Google BigQuery (bêta)