Carga datos de HubSpot en BigQuery

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Para obtener asistencia o enviar comentarios sobre esta función, comunícate con [e-mail].

Puedes cargar datos de HubSpot a BigQuery con el conector del Servicio de transferencia de datos de BigQuery para HubSpot. Con el Servicio de transferencia de datos de BigQuery, puedes programar trabajos de transferencia recurrentes que agreguen tus datos más recientes de HubSpot a BigQuery.

Limitaciones

• El conector de HubSpot requiere un token de acceso de app privada para la autenticación. Debes tener una app privada de HubSpot para tener un token de acceso a la app privada antes de poder configurar una transferencia de datos de HubSpot. Para obtener más información, consulta los requisitos previos de HubSpot.
• Si tu adjunto de red se creó en un proyecto de Google Cloud que es diferente del proyecto de Google Cloud de la transferencia de datos, debes otorgar los permisos compute.networkAttachments.get y compute.networkAttachments.update al agente de servicio que pertenece al proyecto de Google Cloud en el que se creó la transferencia de datos.

Antes de comenzar

En las siguientes secciones, se describen los requisitos previos que debes cumplir antes de crear una transferencia de datos de HubSpot.

Requisitos previos de HubSpot

Debes crear una app privada de HubSpot y recuperar el token de acceso de la app privada. Para obtener más información, consulta lo siguiente:

• Crea una app privada
• Consulta la información del token de acceso a la app privada

Permisos obligatorios

Los permisos de HubSpot permiten que otros servicios accedan a endpoints de API específicos para acceder a los datos de una cuenta de HubSpot. Para permitir que el conector de HubSpot transfiera datos desde tu cuenta de HubSpot, debes habilitar los siguientes permisos para tu app privada:

Permisos obligatorios

• automation
• business-intelligence
• collector_graphql_query_execute
• collector_graphql_query_read
• content
• conversations.read
• conversations.visitor_identification.tokens.create
• crm.import
• crm.lists.read
• crm.objects.companies.read
• crm.objects.contacts.read
• crm.objects.deals.read
• crm.objects.owners.read
• crm.schemas.companies.read
• crm.schemas.contacts.read
• crm.schemas.deals.read
• e-commerce
• files
• forms
• forms-uploaded-files
• hubdb
• integration-sync
• oauth
• sales-email-read
• settings.users.read
• settings.users.teams.read
• social
• tickets
• timeline
• transactional-email

Para obtener información sobre cómo configurar permisos para tu app privada, consulta Apps privadas heredadas.

Permisos opcionales

Para transferir ciertos objetos de datos de HubSpot, como datos sensibles o muy sensibles, también debes habilitar los siguientes permisos:

Permisos para datos sensibles

Para transferir datos sensibles, habilita los siguientes permisos:

• crm.objects.contacts.sensitive.read
• crm.objects.companies.sensitive.read
• crm.objects.deals.sensitive.read
• crm.objects.appointments.sensitive.read
• crm.objects.custom.sensitive.read
• crm.objects.projects.sensitive.read
• tickets.sensitive

Permisos para datos altamente sensibles

Para transferir datos muy sensibles, habilita los siguientes permisos:

• crm.objects.contacts.highly_sensitive.read
• crm.objects.companies.highly_sensitive.read
• crm.objects.deals.highly_sensitive.read
• crm.objects.custom.highly_sensitive.read
• crm.objects.projects.highly_sensitive.read
• tickets.highly_sensitive

Permisos para otros datos

Algunos objetos de datos requieren que se incluyan permisos específicos en una transferencia de datos. Por ejemplo, para transferir objects.courses, debes tener el permiso crm.objects.courses.read. En la siguiente lista, se incluyen los permisos necesarios para transferir el objeto de datos correspondiente:

• crm.objects.appointments.read
• crm.objects.courses.read
• crm.objects.custom.read
• crm.objects.goals.read
• crm.objects.leads.read
• crm.objects.line_items.read
• crm.objects.listings.read
• crm.objects.orders.read
• crm.objects.owners.read
• crm.objects.products.read
• crm.objects.services.read
• crm.objects.users.read
• crm.pipelines.orders.read
• crm.schemas.appointments.read
• crm.schemas.courses.read
• crm.schemas.custom.read
• crm.schemas.deals.read
• crm.schemas.line_items.read
• crm.schemas.listings.read
• crm.schemas.orders.read
• crm.schemas.quotes.read
• crm.schemas.services.read
• marketing.campaigns.read
• marketing.campaigns.revenue.read
• settings.users.read
• settings.users.teams.read
• crm.dealsplits.read_write
• crm.export
• crm.extensions_calling_transcripts.read
• crm.schemas.carts.read
• crm.objects.carts.read
• crm.objects.subscriptions.read
• crm.objects.commercepayments.read
• crm.objects.projects.read
• crm.objects.quotes.read
• crm.objects.partner-clients.read
• crm.objects.partner-services.read
• crm.objects.marketing_events.read
• crm.objects.invoices.read
• crm.objects.feedback_submissions.read
• crm.objects.forecasts.read
• crm.schemas.commercepayments.read
• crm.schemas.forecasts.read
• crm.schemas.invoices.read
• crm.schemas.projects.read
• crm.schemas.subscriptions.read

Requisitos previos de BigQuery

• Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery.
• Crea un conjunto de datos de BigQuery para almacenar tus datos.

Roles de BigQuery requeridos

Para obtener los permisos que necesitas para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery, pídele a tu administrador que te otorgue el rol de IAM de administrador de BigQuery (roles/bigquery.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery:

• Permisos del Servicio de transferencia de datos de BigQuery:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Permisos de BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información, consulta Otorga acceso a bigquery.admin.

Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, asegúrate de tener el permiso de IAM pubsub.topics.setIamPolicy. Los permisos de Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Configura una transferencia de datos de HubSpot

Agrega datos de HubSpot a BigQuery configurando una configuración de transferencia con una de las siguientes opciones:

Console

1. Ve a la página Transferencia de datos en la consola de Google Cloud .

   Ir a Transferencias de datos

2. Haz clic en Crear transferencia.

3. En la sección Tipo de fuente, en Fuente, elige HubSpot - Vista previa.

4. En la sección Detalles de fuente de datos, haz lo siguiente:

   • En Token de acceso, ingresa la clave de tu token de acceso privado. Para obtener más información, consulta Requisitos previos de HubSpot.
   • En Objetos de HubSpot para transferir, haz clic en Explorar y selecciona los objetos que se transferirán al conjunto de datos de destino de BigQuery. También puedes ingresar de forma manual cualquier objeto que quieras incluir en la transferencia de datos en este campo.
     • Puedes seleccionar objetos personalizados de HubSpot, que aparecen en el menú Explorar con el formato CUSTOM_OBJECT_NAME__c.

5. En la sección Configuración de destino, en Conjunto de datos, elige el conjunto de datos que creaste para almacenar tus datos.

6. En la sección Nombre de configuración de la transferencia (Transfer config name), en Nombre visible (Display name), ingresa el nombre de la transferencia de datos.

7. En la sección Opciones de programación, haz lo siguiente:

   • En la lista Frecuencia de repetición, selecciona una opción para especificar la frecuencia con la que se ejecuta esta transferencia de datos. Para especificar una frecuencia de repetición personalizada, selecciona Personalizado. Si seleccionas Según demanda, esta transferencia se ejecuta cuando activas la transferencia de forma manual.
   • Si corresponde, selecciona Comenzar ahora o Comenzar a la hora definida y detalla una fecha de inicio y una hora de ejecución.

8. Opcional: En la sección Opciones de notificación, haz lo siguiente:

   • Para habilitar las notificaciones por correo electrónico, haz clic en el botón de activar o desactivar Notificación por correo electrónico. Si habilitas esta opción, el administrador de transferencias recibirá una notificación por correo electrónico cuando falle la ejecución de una transferencia.
   • Si quieres habilitar las notificaciones de ejecución de transferencias de Pub/Sub para esta transferencia, haz clic en el botón de activar Notificaciones de Pub/Sub. Puedes seleccionar el nombre del tema o hacer clic en Crear un tema para crear uno.

9. Haz clic en Guardar.

bq

Ingresa el comando bq mk y suministra la marca de creación de transferencias --transfer_config.

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

Reemplaza lo siguiente:

• PROJECT_ID (opcional): Es el ID del proyecto de Google Cloud . Si no se proporciona --project_id para especificar un proyecto en particular, se usa el proyecto predeterminado.
• DATA_SOURCE: La fuente de datos: hubspot.
• NAME: el nombre visible de la configuración de transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.
• DATASET es el conjunto de datos de destino para la configuración de transferencia.

• PARAMETERS son los parámetros de la configuración de transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}' Los siguientes son los parámetros para una transferencia de datos de HubSpot:

  • assets: Es la ruta de acceso a los objetos de HubSpot que se transferirán a BigQuery.
    • Puedes especificar objetos personalizados de HubSpot con el formato CUSTOM_OBJECT_NAME__c.
  • connector.authentication.oauth.accessToken: Es la clave del token de acceso privado de HubSpot.

Con el siguiente comando, se crea una transferencia de datos de HubSpot en el proyecto predeterminado.

    bq mk \
        --transfer_config \
        --target_dataset=mydataset \
        --data_source=hubspot \
        --display_name='My Transfer' \
        --params= ' {
            "assets": ["Contacts", "Deals"],
            "connector.authentication.oauth.accessToken": "pat_123456789123"}'

Cuando guardas la configuración de la transferencia, el conector de HubSpot activa automáticamente una ejecución de transferencia según la opción de programación que elijas. Con cada ejecución de transferencia, el conector de HubSpot transfiere todos los datos disponibles de HubSpot a BigQuery.

Para ejecutar de forma manual una transferencia de datos fuera de tu programa habitual, puedes iniciar una ejecución de reabastecimiento.

Asignación de tipos de datos

En la siguiente tabla, se asignan los tipos de datos de HubSpot a los tipos de datos de BigQuery correspondientes:

Tipo de datos de HubSpot	Tipo de datos de BigQuery
String	STRING
Text	STRING
Integer	INTEGER
Boolean	BOOLEAN
Date	TIMESTAMP
Datetime	TIMESTAMP
Long	BIGNUMERIC

Precios

No se aplican costos por transferir datos de HubSpot a BigQuery mientras esta función está en versión preliminar.

Soluciona problemas con la configuración de una transferencia

Si tienes problemas para configurar tu transferencia de datos, consulta Problemas de transferencia de HubSpot.

¿Qué sigue?

• Para obtener una descripción general del Servicio de transferencia de datos de BigQuery, consulta ¿Qué es el Servicio de transferencia de datos de BigQuery?.
• Para obtener información sobre el uso de las transferencias (por ejemplo, cómo obtener información sobre una configuración de transferencia, mostrar distintas configuraciones o visualizar su historial de ejecuciones), consulta Administra transferencias.
• Obtén información para cargar datos con las operaciones de BigQuery Omni.