Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Accesso ai dati di HubSpot in Google BigQuery (BETA)

Ultimo aggiornamento: 1 giugno 2026

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Data Hub Enterprise

Dopo aver collegato Google BigQuery al tuo account HubSpot, potrai eseguire query sui dati di HubSpot in BigQuery.

Questo articolo fornisce informazioni sullo schema di ciascuna tabella sincronizzata con BigQuery, che puoi utilizzare insieme alla documentazione di Google per eseguire query sui dati di HubSpot nel tuo account BigQuery.

Panoramica dei dati

Le query sono costruite utilizzando SQL e possono essere utilizzate per recuperare dati HubSpot quali:

Oggetti: oggetti standard e personalizzati, come contatti, aziende, prodotti.
Record: singoli record, come un singolo contatto o un'azienda.
Associazioni: tutti i tipi di associazione disponibili e i record attualmente associati.
Eventi: dati relativi sia agli eventi standard di HubSpot, come le aperture delle email, sia agli eventi comportamentali personalizzati.

I dati degli oggetti di diversi tipi vengono combinati per la v1: tutti i record per tutti i tipi di oggetti vengono combinati in un unico oggetto del database. Pertanto, durante l’esecuzione di una query, è necessario specificare un filtro del tipo “WHERE objectTypeId=’0-1’

Agli oggetti personalizzati riceveranno un ID al momento della creazione e saranno identificati come 2-unique_ID. Ad esempio, 2-12345.

Scopri di più sul modello di dati CRM di HubSpot.

Schemi delle tabelle sincronizzate

Le sezioni seguenti forniscono dettagli sullo schema di ciascuna tabella sincronizzata dal tuo account HubSpot a BigQuery, in base alle impostazioni di sincronizzazione configurate.

Schema object_properties

Lo schema riportato di seguito fornisce dettagli sulla tabella object_properties sincronizzata:

Nome colonna	Tipo	Descrizione
OBJECTTYPEID	STRING	L'ID del tipo di oggetto (ad es. 0-1 per i contatti).
OBJECTID	INT64	L'ID del record (ad es. 123752 come record di contatto di esempio).
NAME	STRING	Il nome della proprietà.
VALORE	JSON	Il valore della proprietà
DATA_AGGIORNAMENTO	TIMESTAMP	Data e ora dell'ultimo aggiornamento del record in HubSpot.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

Schema object_with_object_properties

Lo schema riportato di seguito fornisce dettagli sulla tabella object_with_object_properties sincronizzata:

Nome colonna	Tipo	Descrizione
OBJECTTYPEID	STRING	L'ID del tipo di oggetto (ad es. 0-1 per i contatti).
OBJECTID	INT64	L'ID del record (ad es. 123752 come record di contatto di esempio).
PROPRIETÀ	JSON	I valori delle proprietà del record
DATA_AGGIORNAMENTO	TIMESTAMP	Data e ora dell'ultimo aggiornamento del record in HubSpot.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

Schema associations_x_to_y

Lo schema riportato di seguito fornisce i dettagli della tabella associations_x_to_y_ sincronizzata:

Nome colonna	Tipo	Descrizione
COMBINEDASSOCIATIONTYPEID	STRING	L'identificatore univoco per la definizione specifica dell'associazione.
CATEGORIAASSOCIAZIONE	STRING	Origine del tipo di associazione. I valori possibili includono: HUBSPOT_DEFINED, USER_DEFINED o INTEGRATOR_DEFINED.
ID_TIPO_ASSOCIAZIONE	STRING	Un identificatore univoco per una definizione di associazione all'interno della sua ASSOCIATIONCATEGORY. Non esistono due definizioni nella stessa categoria che condividano questo ID.
FROMOBJECTTYPEID	STRING	L'ID del tipo di oggetto dell'oggetto di origine dell'associazione.
FROMOBJECTTYPE	STRING	Il nome del tipo di oggetto di origine dell'associazione.
ID_TIPO_OGGETTO_DI_DESTINAZIONE	STRING	ID del tipo di oggetto di destinazione dell'associazione.
TOOBJECTTYPE	STRING	Il nome del tipo di oggetto di destinazione dell'associazione.
NAME	STRING	Il nome definito della definizione dell'associazione.
LABEL	STRING	Etichetta descrittiva della definizione dell'associazione.
ISMAINASSOCIATIONDEFINITION	BOOLEANO	Indica se si tratta del tipo di associazione principale (vero), ovvero quello che HubSpot visualizza sui record associati.
[FROMOBJECTTYPE_OBJECTID]	INT64	L'ID oggetto del record di origine. (ad es., CONTACT_OBJECTID per una vista ASSOCIATIONS_CONTACTS_TO_DEALS).
[TOOBJECTTYPE_OBJECTID]	INT64	L'ID oggetto del record di destinazione. (ad es., DEAL_OBJECTID per una vista ASSOCIATIONS_CONTACTS_TO_DEALS).
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

schema associations

Lo schema riportato di seguito fornisce i dettagli della tabella associations sincronizzata:

Nome colonna	Tipo	Descrizione
COMBINEDASSOCIATIONTYPEID	STRING	L'identificatore univoco della definizione dell'associazione.
ID_OGGETTO_DI_ORIGINE	INT64	L'ID dell'oggetto di origine.
TOOBJECTID	INT64	L'ID dell'oggetto di destinazione.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

schema association_definitions

Lo schema riportato di seguito fornisce i dettagli della tabella associations_definitions sincronizzata:

Nome colonna	Tipo	Descrizione
COMBINEDASSOCIATIONTYPEID	STRING	L'identificatore univoco della definizione specifica dell'associazione.
CATEGORIAASSOCIAZIONE	STRING	Origine del tipo di associazione. I valori possibili includono: HUBSPOT_DEFINED, USER_DEFINED o INTEGRATOR_DEFINED.
ID_TIPO_ASSOCIAZIONE	STRING	Un identificatore univoco per una definizione di associazione all'interno della sua ASSOCIATIONCATEGORY. Non esistono due definizioni nella stessa categoria che condividano questo ID.
FROMOBJECTTYPEID	STRING	L'ID del tipo di oggetto dell'oggetto di origine dell'associazione.
FROMOBJECTTYPE	STRING	Il nome del tipo di oggetto di origine dell'associazione.
ID_TIPO_OGGETTO_DI_DESTINAZIONE	STRING	ID del tipo di oggetto di destinazione dell'associazione.
TOOBJECTTYPE	STRING	Il nome del tipo di oggetto di destinazione dell'associazione.
NAME	STRING	Il nome definito della definizione dell'associazione.
LABEL	STRING	Etichetta descrittiva della definizione dell'associazione.
ISMAINASSOCIATIONDEFINITION	BOOLEANO	Indica se si tratta del tipo di associazione principale (vero), ovvero quello che HubSpot visualizza sui record associati.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultima acquisizione del record da parte di BigQuery.

Eventi

Gli eventi includono eventi HubSpot standard ed eventi comportamentali personalizzati. Ogni evento ha un proprio oggetto database, denominato events_eventname.

Nome
EVENTS_AD_INTERACTION	Dettagli di un annuncio e dei contatti che hanno interagito con esso cliccandoci sopra o inviando un modulo dopo aver interagito con esso.
EVENTS_AD_METRICS_IMPORTED_V0	Dettagli di un annuncio e delle relative metriche di rendimento.
EVENTS_CALL_MENTIONED_KEYWORD	Dettagli delle parole chiave menzionate da qualsiasi partecipante alle chiamate.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Link cliccati nelle email di marketing dai contatti.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Link cliccati nelle email della Posta in arrivo di Conversations dai contatti.
EVENTS_COOKIE_BANNER_CLICKED	Contatti che hanno cliccato sui cookie.
EVENTS_COOKIE_BANNER_VIEWED	Contatti che hanno visualizzato i cookie.
EVENTS_DOCUMENT_SHARED_V2	Documenti di vendita condivisi con i contatti tramite un link esterno.
EVENTS_DOCUMENT_VIEWED_V2	Documenti di vendita e contatti che li hanno visualizzati aprendo il link esterno.
EVENTS_DOCUMENT_COMPLETED_V2	Documenti di vendita e contatti che li hanno chiusi.
EVENTS_HS_SCHEDULED_EMAIL_V2	Email inviate ai server di posta di HubSpot per essere spedite.
EVENTS_MTA_DELIVERED_EMAIL_V2	Email consegnate con successo ai destinatari dai server di posta di HubSpot.
EVENTS_MTA_BOUNCED_EMAIL_V2	Tentativi di consegna delle email che sono stati rifiutati dal server di posta del destinatario.
EVENTS_OPENED_EMAIL_V2	Aperture delle email da parte dei contatti.
EVENTS_REPORTED_SPAM_EMAIL_V2	Email contrassegnate come spam dai destinatari.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Modifiche alle iscrizioni alle email da parte dei destinatari.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Aperture delle email nella Posta in arrivo monitorata da parte dei contatti.
EVENTS_MB_MEDIA_PLAYED	Attività di riproduzione video per contatto.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Il contatto ha prenotato una riunione tramite sequenza.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Il contatto si è iscritto alla sequenza.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sequenza completata.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Il contatto ha risposto all'e-mail (o all'e-mail in arrivo che ha annullato l'iscrizione alla sequenza) inviata tramite la sequenza.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Il contatto si è cancellato dalla sequenza.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	L'utente ha cancellato manualmente il contatto.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Il contatto si è disiscritto, cancellandosi dalla sequenza.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	L'email della sequenza è stata respinta.
EVENTS_V2_SEQUENCE_ERRORED	Errore nella sequenza che ha causato la cancellazione.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Fase della sequenza eseguita.
EVENTS_VISITED_PAGE	Visite alle pagine del sito web da parte dei contatti.
EVENTS_<NOME_EVENTO_INTEGRAZIONE>_<IDENTIFICATORE_UNICO>	Eventi di integrazione (API Timeline V3)

È possibile identificare gli eventi combinando l'ID del tipo di evento e l'ID. Le colonne restituite dipendono dall'evento, con una colonna per ogni proprietà dell'evento. Tutti gli eventi restituiranno le seguenti colonne:

Nome colonna	Tipo	Descrizione
`EVENTTYPEID`	STRING	L'ID del tipo di evento, simile a OBJECTTYPEID È possibile interrogare tutti gli ID dei tipi di evento nel proprio account utilizzando la vista object_and_event_type_definitions.
`ID`	STRING	È univoco per ogni tipo di evento. Non esistono due record con lo stesso ID all'interno di un dato tipo di evento.
`OBJECTTYPEID`	STRING	Il tipo di oggetto che ha completato l'evento. Ad esempio, un clic su un link contenuto in un'e-mail mostrerebbe`0-1` in questa colonna, a indicare l'oggetto "contatti".
`OBJECTID`	INT64	L'ID del record che ha completato l'evento.
`OCCURREDAT`	TIMESTAMP	Quando si è verificato l'evento.
`OCCURREDATDATEINT`	INT64	Un numero che rappresenta il momento in cui si è verificato l'evento. Contiene gli stessi dati della colonna `OCCURREDAT`, ma formattati come numero e utilizzati come parte della chiave cluster della tabella. Nella maggior parte dei casi, è possibile utilizzare il timestamp `OCCURREDAT` al posto di questo numero.
`OCCUREDATDATEINT`	Numero	Un numero che rappresenta il momento in cui si è verificato l'evento. Contiene gli stessi dati della colonna `OCCURREDAT`, ma è formattato come numero e utilizzato come parte della chiave di cluster della tabella. Nella maggior parte dei casi, è possibile utilizzare il timestamp `OCCURREDAT` al posto di questo numero.
`INGESTEDAT`	Data e ora	Data e ora dell'ultimo inserimento dei dati in BigQuery. Ulteriori informazioni sui tipi di dati delle colonne.
`PROPERTY_*`	Varchar	Singole colonne contenenti le proprietà dell'evento.

L'articolo è stato utile?

Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.

BetaAccesso ai dati di HubSpot in Google BigQuery (BETA)