Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado.

Accede a los datos de HubSpot en Google BigQuery (BETA)

Última actualización: 1 de junio de 2026

Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:

Data Hub Enterprise

Después de conectar Google BigQuery a tu cuenta de HubSpot, puedes consultar los datos de HubSpot en BigQuery.

Este artículo proporciona información sobre el esquema de cada tabla sincronizada con BigQuery, que puedes utilizar junto con la documentación de Google para consultar los datos de HubSpot en tu cuenta de BigQuery.

Resumen de datos

Las consultas se construyen utilizando SQL, y se pueden utilizar para recuperar datos de HubSpot tales como:

Objetos: objetos estándar y personalizados, como contactos, empresas, productos.
Registros: registros individuales, como un contacto individual o una empresa.
Asociaciones: todos los tipos de asociación disponibles y los registros asociados actualmente.
Eventos: datos de eventos tanto para eventos estándar de HubSpot, como aperturas de correos electrónicos, como para eventos de comportamiento personalizados.

Los datos de objetos de distintos tipos se combinan para v1: todos los registros de todos los tipos de objetos se combinan en un objeto de base de datos. Por lo tanto, al realizar una consulta, es necesario especificar un filtro del tipo “WHERE objectTypeId=’0-1’.

A los objetos personalizados se les asignará un ID en el momento de su creación, y se identificarán como 2-unique_ID. Por ejemplo, 2-12345.

Más información sobre el modelo de datos CRM de HubSpot.

Esquemas de tablas sincronizados

Las secciones siguientes proporcionan detalles sobre el esquema de cada tabla sincronizada desde tu cuenta de HubSpot a BigQuery, en función de los ajustes de sincronización configurados.

esquema propiedades_objeto

El siguiente esquema proporciona detalles de la tabla object_properties sincronizada:

Nombre de la columna	Tipo	Descripción
OBJECTTYPEID	CADENA	El ID del tipo de objeto (por ejemplo, 0-1 para contactos).
OBJECTID	INT64	El ID del registro (por ejemplo, 123752 como ejemplo de registro de contacto).
NOMBRE	CADENA	El nombre de la propiedad.
VALUE	JSON	Valor de la propiedad
UPDATEDAT	TIMESTAMP	La fecha y hora en que el registro fue actualizado por última vez en HubSpot.
INGESTEDAT	TIMESTAMP	La fecha y hora en que el registro fue ingestado por última vez por BigQuery.

esquema objeto_con_propiedades_del_objeto

El siguiente esquema proporciona detalles de la tabla object_with_object_properties sincronizada:

Nombre de la columna	Tipo	Descripción
OBJECTTYPEID	CADENA	El ID del tipo de objeto (por ejemplo, 0-1 para contactos).
OBJECTID	INT64	El ID del registro (por ejemplo, 123752 como ejemplo de registro de contacto).
PROPERTIES	JSON	Valores de propiedad del registro
UPDATEDAT	TIMESTAMP	La fecha y hora en que el registro fue actualizado por última vez en HubSpot.
INGESTEDAT	TIMESTAMP	La fecha y hora en que el registro fue ingestado por última vez por BigQuery.

asociaciones_x_a_y esquema

El siguiente esquema proporciona detalles de la tabla associations_x_to_y_ sincronizada:

Nombre de la columna	Tipo	Descripción
COMBINEDASSOCIATIONTYPEID	CADENA	El identificador único para la definición específica de la asociación.
ASOCIACIÓNCATEGORÍA	CADENA	El origen del tipo de asociación. Los valores posibles son: HUBSPOT_DEFINED, USER_DEFINED o INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	CADENA	Identificador único para una definición de asociación dentro de su ASSOCIATIONCATEGORY. No habrá dos definiciones de la misma categoría que compartan este ID.
FROMOBJECTTYPEID	CADENA	El ID del tipo de objeto del objeto fuente de la asociación.
FROMOBJECTTYPE	CADENA	El nombre del tipo de objeto fuente de la asociación.
TOOBJECTTYPEID	CADENA	El ID de tipo de objeto del objeto de destino de la asociación.
TOOBJECTTYPE	CADENA	El nombre del tipo de objeto de destino de la asociación.
NOMBRE	CADENA	El nombre definido de la definición de la asociación.
LABEL	CADENA	Una etiqueta descriptiva para la definición de la asociación.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Indica si este es el tipo de asociación principal (true), que es el que HubSpot muestra en los registros asociados.
[FROMOBJECTTYPE_OBJECTID]	INT64	El ID de objeto del registro de origen. (por ejemplo, CONTACT_OBJECTID para una vista ASSOCIATIONS_CONTACTS_TO_DEALS).
[TOOBJECTTYPE_OBJECTID]	INT64	El ID de objeto del registro de destino. (por ejemplo, DEAL_OBJECTID para una vista ASSOCIATIONS_CONTACTS_TO_DEALS).
INGESTEDAT	TIMESTAMP	La fecha y hora en que el registro fue ingestado por última vez por BigQuery.

esquema de asociaciones

El siguiente esquema proporciona detalles de la tabla de asociaciones sincronizadas:

Nombre de la columna	Tipo	Descripción
COMBINEDASSOCIATIONTYPEID	CADENA	El identificador único de la definición de la asociación.
FROMOBJECTID	INT64	El ID del objeto fuente.
TOOBJECTID	INT64	El ID del objeto de destino.
INGESTEDAT	TIMESTAMP	La fecha y hora en que el registro fue ingestado por última vez por BigQuery.

esquema_definiciones_asociativas

El siguiente esquema proporciona detalles de la tabla associations_definitions sincronizada:

Nombre de la columna	Tipo	Descripción
COMBINEDASSOCIATIONTYPEID	CADENA	El identificador único para la definición específica de la asociación.
ASOCIACIÓNCATEGORÍA	CADENA	El origen del tipo de asociación. Los valores posibles son: HUBSPOT_DEFINED, USER_DEFINED o INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	CADENA	Identificador único para una definición de asociación dentro de su ASSOCIATIONCATEGORY. No habrá dos definiciones de la misma categoría que compartan este ID.
FROMOBJECTTYPEID	CADENA	El ID del tipo de objeto del objeto fuente de la asociación.
FROMOBJECTTYPE	CADENA	El nombre del tipo de objeto fuente de la asociación.
TOOBJECTTYPEID	CADENA	El ID de tipo de objeto del objeto de destino de la asociación.
TOOBJECTTYPE	CADENA	El nombre del tipo de objeto de destino de la asociación.
NOMBRE	CADENA	El nombre definido de la definición de la asociación.
LABEL	CADENA	Una etiqueta descriptiva para la definición de la asociación.
ISMAINASSOCIATIONDEFINITION	BOOLEAN	Indica si este es el tipo de asociación principal (true), que es el que HubSpot muestra en los registros asociados.
INGESTEDAT	TIMESTAMP	La fecha y hora en que el registro fue ingestado por última vez por BigQuery.

Eventos

Los eventos incluyen eventos estándar de HubSpot y eventos de comportamiento personalizados. Cada acontecimiento tiene su propio objeto de base de datos, etiquetado como events_eventname.

Nombre
EVENTS_AD_INTERACTION	Detalles de un anuncio y de los contactos que han interactuado con él haciendo clic en el anuncio o enviando un formulario después de participar en él.
EVENTS_AD_METRICS_IMPORTED_V0	Detalles de un anuncio y sus métricas de rendimiento.
EVENTS_CALL_MENTIONED_KEYWORD	Detalles de las palabras clave mencionadas por cualquier participante en las convocatorias.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Enlaces en los que los contactos hacen clic en los correos electrónicos de marketing.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Enlaces pulsados en los correos electrónicos de la bandeja de entrada de las conversaciones por los contactos.
EVENTS_COOKIE_BANNER_CLICKED	Contactos que han hecho clic en las cookies.
EVENTS_COOKIE_BANNER_VIEWED	Contactos que vieron cookies.
EVENTS_DOCUMENT_SHARED_V2	Documentos de venta compartidos con los contactos a través de un enlace externo.
EVENTS_DOCUMENT_VIEWED_V2	Documentos de venta y contactos que han visto al abrir el enlace externo.
EVENTS_DOCUMENT_COMPLETED_V2	Documentos de venta y contactos que los han cerrado.
EVENTS_HS_SCHEDULED_EMAIL_V2	Correos electrónicos enviados a los servidores de correo electrónico de HubSpot para ser enviados.
EVENTS_MTA_DELIVERED_EMAIL_V2	Correos electrónicos entregados con éxito a los destinatarios por los servidores de correo electrónico de HubSpot.
EVENTS_MTA_BOUNCED_EMAIL_V2	Intentos de entrega de correo electrónico que fueron rechazados por el servidor de correo electrónico del destinatario.
EVENTS_OPENED_EMAIL_V2	Aperturas de correo electrónico por contactos.
EVENTS_REPORTED_SPAM_EMAIL_V2	Correos electrónicos marcados como spam por los destinatarios.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Cambios en las suscripciones de correo electrónico por parte de los destinatarios.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Conservación de la Bandeja de entrada del correo electrónico se abre por los contactos.
EVENTS_MB_MEDIA_PLAYED	Actividad de reproducción de vídeo por contactos.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	El contacto reservó una reunión a través de la secuencia.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Contacto inscrito a partir de la secuencia.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Secuencia terminada.
EVENTS_V2_CONTACT_REPLIED_EMAIL	El contacto ha respondido al correo electrónico (o al correo electrónico entrante que ha anulado la secuencia) enviado a través de la secuencia.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Contacto no inscrito en la secuencia.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	El usuario ha anulado manualmente el contacto.
EVENTS_V2_CONTACT_UNSUBSCRIBED_EMAIL	El contacto se ha dado de baja, anulando la secuencia.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	El correo electrónico de la secuencia ha sido devuelto.
EVENTS_V2_SEQUENCE_ERRORED	Secuencia errónea que provoca la desinscripción.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Paso de secuencia ejecutado.
PÁGINA_DE_EVENTOS_VISITADOS	Visitas a la página web por contactos.
EVENTOS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Eventos de integración(API de cronología V3)

Puedes identificar los eventos combinando su ID de tipo de evento y su ID. Las columnas que se devuelven dependen del evento, con una columna para cada propiedad del evento. Todos los eventos devolverán las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`EVENTTYPEID`	CADENA	El ID del tipo de evento, similar a OBJECTTYPEID Puede consultar todos los ID de tipo de evento en su cuenta utilizando la vista object_and_event_type_definitions.
`ID`	CADENA	Esto es único por tipo de evento. No habrá dos registros que tengan el mismo ID dentro de un tipo de evento determinado.
`OBJECTTYPEID`	CADENA	El tipo de objeto que completó el evento. Por ejemplo, un clic en un enlace de correo electrónico se mostraría `0-1` en esta columna, que representa el objeto contactos.
`OBJECTID`	INT64	El ID del registro que completó el evento.
`OCCURREDAT`	TIMESTAMP	Cuando ocurrió el evento.
`OCCURREDATDATEINT`	INT64	Un número que representa cuándo ocurrió el evento. Contiene los mismos datos que la columna `OCCURREDAT` pero formateada como un número y utilizada como parte de la clave de grupo de la tabla. En la mayoría de los casos, puedes utilizar el `OCCURREDAT` marca de tiempo en lugar de este número.
`OCCUREDATDATEINT`	Número	Un número que representa cuándo ocurrió el evento. Contiene los mismos datos que la columna `OCCURREDAT` pero formateada como un número y utilizada como parte de la clave de grupo de la tabla. En la mayoría de los casos, puedes utilizar el `OCCURREDAT` marca de tiempo en lugar de este número.
`INGESTEDAT`	Timestamp	Fecha y hora en que BigQuery ingirió los datos por última vez. Más información sobre tipos de datos de columnas.
`PROPERTY_*`	Varchar	Columnas individuales que contienen las propiedades del evento.

¿Te resultó útil este artículo?

Este formulario se utiliza solo para recibir comentarios a la documentación. Cómo recibir ayuda con HubSpot.

BetaAccede a los datos de HubSpot en Google BigQuery (BETA)