HubSpot のデータを BigQuery に読み込む

HubSpot 用 BigQuery Data Transfer Service コネクタを使用して、HubSpot から BigQuery にデータを読み込むことができます。BigQuery Data Transfer Service を使用すると、HubSpot から BigQuery に最新のデータを追加する定期的な転送ジョブのスケジュールを設定できます。

制限事項

HubSpot コネクタには、認証用の限定公開アプリ アクセス トークンが必要です。

  • HubSpot データ転送を設定するには、HubSpot 限定公開アプリの限定公開アプリ アクセストークンが必要です。詳しくは、HubSpot の前提条件をご覧ください。

始める前に

以降のセクションでは、HubSpot のデータ転送を作成する前に必要な前提条件について説明します。

HubSpot の前提条件

HubSpot の限定公開アプリを作成し、限定公開アプリのアクセス トークンを取得する必要があります。詳しくは以下をご覧ください。

必要なスコープ

HubSpot スコープを使用すると、他のサービスが特定の API エンドポイントにアクセスして、HubSpot アカウントのデータにアクセスできます。HubSpot コネクタが HubSpot アカウントからデータを転送できるようにするには、限定公開アプリで次のスコープを有効にする必要があります。

必要なスコープ

  • 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

限定公開アプリのスコープの構成については、以前の限定公開アプリをご覧ください。

省略可能なスコープ

機密データや高度な機密データなど、特定の HubSpot データオブジェクトを転送するには、次のスコープも有効にする必要があります。

センシティブ データのスコープ

センシティブ データを転送するには、次のスコープを有効にします。

  • 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

機密性の高いデータのスコープ

機密性の高いデータを転送するには、次のスコープを有効にします。

  • 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

その他のデータのスコープ

一部のデータ オブジェクトでは、データ転送に特定のスコープを含める必要があります。たとえば、objects.courses を転送するには、スコープ crm.objects.courses.read が必要です。次のリストには、対応するデータ オブジェクトの転送に必要なスコープのリストが含まれています。

  • 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

BigQuery の前提条件

必要な BigQuery のロール

BigQuery Data Transfer Service データ転送の作成に必要な権限を取得するには、プロジェクトに対する