Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa.

Acessar dados do HubSpot no Google BigQuery (BETA)

Ultima atualização: 1 de Junho de 2026

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Data Hub Enterprise

Depois de conectar o Google BigQuery à sua conta da HubSpot, você poderá consultar os dados do HubSpot no BigQuery.

Este artigo fornece informações sobre o esquema de cada tabela sincronizada com o BigQuery, que você pode usar em conjunto com a documentação do Google para consultar dados do HubSpot em sua conta do BigQuery.

Visão geral dos dados

As consultas são construídas usando SQL e podem ser usadas para recuperar dados do HubSpot, como:

Objetos : objetos padrão e personalizados, como contatos, empresas, produtos.
Registros: registros individuais, como um contato individual ou empresa.
Associações: todos os tipos de associação disponíveis e registros associados no momento.
Eventos: dados de eventos para eventos padrão do HubSpot, como aberturas de e-mail, e eventos comportamentais personalizados.

Dados de Objeto de diferentes tipos são combinados para v1: todos os registros de todos os tipos de objeto são combinados em um único objeto de banco de dados. Assim, ao consultar, você precisa especificar um filtro como “WHERE objectTypeId=’0-1’.

Será atribuído um ID aos objetos personalizados no momento da criação, e será identificado como 2-unique_ID. Por exemplo, 2-12345.

Saiba mais sobre Modelo de dados de CRM da HubSpot.

Esquemas de tabela sincronizados

As seções abaixo fornecem detalhes sobre o esquema de cada tabela sincronizada da sua conta da HubSpot para o BigQuery, com base nas configurações de sincronização definidas.

object_properties esquema

O esquema abaixo fornece detalhes da tabela de object_properties sincronizada:

Nome da coluna	Tipo	Descrição
OBJECTTYPEID	SEQÜÊNCIA	O ID do tipo de objeto (por exemplo, 0-1 para contatos).
OBJECTID	INT64	O ID do registro (por exemplo, 123752 como exemplo registro do contato ).
NOME	SEQÜÊNCIA	O nome da propriedade.
VALUE	JSON	O valor da propriedade
UPDATEDAT	CARIMBO DE DATA/HORA	A data e hora em que o registro foi atualizado pela última vez no HubSpot.
INGESTEDAT	CARIMBO DE DATA/HORA	A data e a hora em que o registro foi assimilado pela última vez pelo BigQuery.

object_with_object_properties esquema

O esquema abaixo fornece detalhes da tabela de object_with_object_properties sincronizada:

Nome da coluna	Tipo	Descrição
OBJECTTYPEID	SEQÜÊNCIA	O ID do tipo de objeto (por exemplo, 0-1 para contatos).
OBJECTID	INT64	O ID do registro (por exemplo, 123752 como exemplo registro do contato ).
PROPERTIES	JSON	Os valores de propriedade do registro
UPDATEDAT	CARIMBO DE DATA/HORA	A data e hora em que o registro foi atualizado pela última vez no HubSpot.
INGESTEDAT	CARIMBO DE DATA/HORA	A data e a hora em que o registro foi assimilado pela última vez pelo BigQuery.

associations_x_to_y esquema

O esquema abaixo fornece detalhes da tabela de associations_x_to_y_ sincronizada:

Nome da coluna	Tipo	Descrição
COMBINEDASSOCIATIONTYPEID	SEQÜÊNCIA	O identificador exclusivo para a definição de associação específica.
CATEGORIA DE ASSOCIAÇÃO	SEQÜÊNCIA	A origem do tipo de associação. Os valores possíveis incluem: HUBSPOT_DEFINED, USER_DEFINED ou INTEGRATOR_DEFINED.
ASSOCIAÇÃOTYPEID	SEQÜÊNCIA	Um identificador exclusivo para uma definição de associação dentro de sua ASSOCIATIONCATEGORY. Duas definições na mesma categoria não compartilharão este ID.
FROMOBJECTTYPEID	SEQÜÊNCIA	O ID do tipo de objeto do objeto de origem da associação.
FROMOBJECTTYPE	SEQÜÊNCIA	O nome do tipo de objeto de origem da associação.
TOOBJECTTYPEID	SEQÜÊNCIA	O ID do tipo de objeto do objeto de destino da associação.
TOOBJECTTYPE	SEQÜÊNCIA	O nome do tipo de objeto de destino da associação.
NOME	SEQÜÊNCIA	O nome definido da definição da associação.
LABEL	SEQÜÊNCIA	Um rótulo descritivo para a definição da associação.
ISMAINASSOCIATIONDEFINITION	BOOLEANO	Indica se este é o tipo de associação principal (true), que é o que o HubSpot exibe nos registros associados.
[FROMOBJECTTYPE_OBJECTID]	INT64	O ID do Objeto do registro de origem. (por exemplo, CONTACT_OBJECTID para uma exibição ASSOCIATIONS_CONTACTS_TO_DEALS).
[TOOBJECTTYPE_OBJECTID]	INT64	O ID do Objeto do registro de destino. (por exemplo, DEAL_OBJECTID para uma exibição ASSOCIATIONS_CONTACTS_TO_DEALS).
INGESTEDAT	CARIMBO DE DATA/HORA	A data e a hora em que o registro foi assimilado pela última vez pelo BigQuery.

esquema de associações

O esquema abaixo fornece detalhes da tabela de associações sincronizadas:

Nome da coluna	Tipo	Descrição
COMBINEDASSOCIATIONTYPEID	SEQÜÊNCIA	O identificador único da definição da associação.
FROMOBJECTID	INT64	O ID do objeto fonte.
TOOBJECTID	INT64	O ID do objeto de destino.
INGESTEDAT	CARIMBO DE DATA/HORA	A data e a hora em que o registro foi assimilado pela última vez pelo BigQuery.

association_definitions esquema

O esquema abaixo fornece detalhes da tabela de associations_definitions sincronizada:

Nome da coluna	Tipo	Descrição
COMBINEDASSOCIATIONTYPEID	SEQÜÊNCIA	O identificador exclusivo para a definição de associação específica.
CATEGORIA DE ASSOCIAÇÃO	SEQÜÊNCIA	A origem do tipo de associação. Os valores possíveis incluem: HUBSPOT_DEFINED, USER_DEFINED ou INTEGRATOR_DEFINED.
ASSOCIAÇÃOTYPEID	SEQÜÊNCIA	Um identificador exclusivo para uma definição de associação dentro de sua ASSOCIATIONCATEGORY. Duas definições na mesma categoria não compartilharão este ID.
FROMOBJECTTYPEID	SEQÜÊNCIA	O ID do tipo de objeto do objeto de origem da associação.
FROMOBJECTTYPE	SEQÜÊNCIA	O nome do tipo de objeto de origem da associação.
TOOBJECTTYPEID	SEQÜÊNCIA	O ID do tipo de objeto do objeto de destino da associação.
TOOBJECTTYPE	SEQÜÊNCIA	O nome do tipo de objeto de destino da associação.
NOME	SEQÜÊNCIA	O nome definido da definição da associação.
LABEL	SEQÜÊNCIA	Um rótulo descritivo para a definição da associação.
ISMAINASSOCIATIONDEFINITION	BOOLEANO	Indica se este é o tipo de associação principal (true), que é o que o HubSpot exibe nos registros associados.
INGESTEDAT	CARIMBO DE DATA/HORA	A data e a hora em que o registro foi assimilado pela última vez pelo BigQuery.

Eventos

Os eventos incluem eventos padrão e eventos comportamentais personalizados do HubSpot. Cada evento tem seu próprio objeto de banco de dados, rotulado como events_eventname.

Nome
EVENTS_AD_INTERACTION	Detalhes de um anúncio e contatos que interagiram com ele clicando no anúncio ou enviando um formulário após interagir com ele.
EVENTS_AD_METRICS_IMPORTED_V0	Detalhes de um anúncio e suas métricas de desempenho.
EVENTS_CALL_MENTIONED_KEYWORD	Detalhes das palavras-chave mencionadas por quaisquer participantes nas chamadas.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Links clicados em e-mails de marketing por contatos.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Links clicados em e-mails da Caixa de entrada de conversas por contatos.
EVENTS_COOKIE_BANNER_CLICKED	Contatos que clicaram em cookies.
EVENTS_COOKIE_BANNER_VIEWED	Contatos que visualizaram cookies.
EVENTS_DOCUMENT_SHARED_V2	Documentos de vendas compartilhados com contatos através de um link externo.
EVENTS_DOCUMENT_VIEWED_V2	Documentos de vendas e contatos que foram visualizados por eles abrindo o link externo.
EVENTS_DOCUMENT_COMPLETED_V2	Documentos de vendas e contatos que os fecharam.
EVENTS_HS_SCHEDULED_EMAIL_V2	Emails enviados aos servidores de email da HubSpot para serem enviados.
EVENTS_MTA_DELIVERED_EMAIL_V2	Emails entregues com sucesso aos destinatários pelos servidores de email HubSpot.
EVENTS_MTA_BOUNCED_EMAIL_V2	Tentativas de entrega de email rejeitadas pelo servidor de email do destinatário.
EVENTS_OPENED_EMAIL_V2	O e-mail é aberto por contatos.
EVENTS_REPORTED_SPAM_EMAIL_V2	Emails marcados como spam pelos destinatários.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Alterações nas assinaturas de e-mail por destinatários.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	O e-mail da caixa de entrada do Conservations é aberto pelos contatos.
EVENTS_MB_MEDIA_PLAYED	Atividade de reprodução de vídeo por contatos.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	O contato reservou uma reunião por meio de sequência.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Contato inscrito na sequência.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sequência finalizada.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	O contato respondeu ao e-mail (ou e-mail recebido cuja sequência cancelada) enviado por meio da sequência.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Contato cancelado da sequência.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	O usuário cancelou manualmente a inscrição do contato.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Contato cancelado, cancelando a inscrição da sequência.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	E-mail de sequência devolvido.
EVENTS_V2_SEQUENCE_ERRORED	Sequência com erro causando cancelamento de inscrição.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Etapa de sequência executada.
EVENTS_VISITED_PAGE	Visitas à página do site por contatos.
EVENTOS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Eventos de integração (API da Linha do tempo V3)

Você pode identificar eventos combinando o ID e o ID do tipo de evento. As colunas que são devolvidas dependem do evento, com uma coluna para cada propriedade do evento. Todos os eventos retornarão as seguintes colunas:

Nome da coluna	Tipo	Descrição
`EVENTTYPEID`	SEQÜÊNCIA	O ID do tipo de evento, semelhante a OBJECTTYPEID Você pode consultar todos os IDs de tipo de evento em sua conta usando o object_and_event_type_definitions visualizar.
`ID`	SEQÜÊNCIA	Isso é exclusivo por tipo de evento. Dois registros não terão o mesmo ID em um determinado tipo de evento.
`OBJECTTYPEID`	SEQÜÊNCIA	O tipo de objeto que completou o evento. Por exemplo, um clique em um link de e-mail exibiria `0-1` nesta coluna, representando o objeto de contatos.
`OBJECTID`	INT64	O ID do registro que completou o evento.
`OCCURREDAT`	CARIMBO DE DATA/HORA	Quando o evento ocorreu.
`OCCURREDATDATEINT`	INT64	Um número que representa quando o evento ocorreu. Contém os mesmos dados que o `OCCURREDAT` coluna, mas formatada como um número e usada como parte da chave de cluster da tabela. Na maioria dos casos, você pode usar o `OCCURREDAT` carimbo de data / hora em vez deste número.
`OCCUREDATDATEINT`	Número	Um número que representa quando o evento ocorreu. Contém os mesmos dados que o `OCCURREDAT` coluna, mas formatada como um número e usada como parte da chave de cluster da tabela. Na maioria dos casos, você pode usar o `OCCURREDAT` carimbo de data / hora em vez deste número.
`INGESTEDAT`	Data/hora	A data e a hora em que os dados foram consumidos pela última vez pelo BigQuery. Saiba mais sobre os tipos de dados das colunas.
`PROPERTY_*`	Varchar	Colunas individuais que contêm as propriedades do evento.

Esse artigo foi útil?

Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.

BetaAcessar dados do HubSpot no Google BigQuery (BETA)