管理訂閱內容

Analytics Hub 訂閱者可以執行下列工作：

  • 訂閱產品資訊。
  • 列出指定專案中目前的訂閱項目。
  • 刪除訂閱項目。

Analytics Hub 發布者可以執行下列工作：

  • 查看商家資訊的所有訂閱項目。
  • 撤銷特定訂閱項目的存取權。

訂閱項目是位於訂閱者專案中的區域性資源。訂閱項目會儲存訂閱者的相關資訊，並代表發布商與訂閱者之間的合約。

事前準備

如要開始使用 BigQuery sharing (舊稱 Analytics Hub)，您必須在 Google Cloud 專案中啟用 Analytics Hub API。

所需權限

如要啟用 Analytics Hub API，您必須具備下列身分與存取權管理 (IAM) 權限：

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

以下是具有啟用 Analytics Hub API 所需權限的預先定義 IAM 角色：

  • roles/serviceusage.serviceUsageAdmin

如要進一步瞭解 BigQuery 中的 IAM 角色，請參閱「預先定義的角色與權限」一文。

啟用 Analytics Hub API

如要啟用 Analytics Hub API，請按照下列步驟操作：

控制台

前往 Analytics Hub API 頁面，為您的 Google Cloud 專案啟用 Analytics Hub API。

啟用 Analytics Hub API

gcloud

執行 gcloud services enable 指令：

gcloud services enable analyticshub.googleapis.com

所需權限

如要管理訂閱項目，您必須具備下列任一 BigQuery sharing (原為 Analytics Hub) 角色：

  • Analytics Hub 訂閱項目擁有者角色 (roles/analyticshub.subscriptionOwner)，可讓您管理自己建立的訂閱項目。

詳情請參閱「Analytics 資料中心使用者角色」。

訂閱者工作流程

訂閱者可以執行下列操作。

訂閱產品資訊

如要訂閱商家資訊，請按照「訂閱商家資訊」中的步驟操作。

可列出訂閱項目

如要列出所有訂閱項目，請按照下列步驟操作。

API

如要查看特定專案中目前的訂閱項目，請使用 projects.locations.subscriptions.list 方法。

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

更改下列內容：

  • PROJECT_ID：包含要列出的訂閱項目的專案 ID。

  • LOCATION：您要列出現有訂閱項目的位置。

發布商工作流程

發布商可以對訂閱項目執行下列操作。如要進一步瞭解如何管理商家資訊訂閱項目，請參閱「管理商家資訊」。

可列出訂閱項目

如要列出所有訂閱項目，請按照下列步驟操作。

主控台

  1. 在 Google Cloud 控制台中，前往「Sharing (Analytics Hub)」(分享 (數據分析中心) 頁面。

    前往「分享」(Analytics Hub)

    系統隨即會顯示一個頁面，列出您可以存取的所有資料交換平台。

  2. 按一下要列出訂閱項目的資料交換名稱。

  3. 按一下「Subscriptions」分頁標籤，即可查看資料交換中所有商家的訂閱項目。

API

如要在特定資料交換中列出產品資訊的訂閱項目，請使用 projects.locations.dataExchanges.listSubscriptions 方法。

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

更改下列內容：

  • PROJECT_ID：您要列出要移除的訂閱項目的資料交換專案 ID。
  • LOCATION：資料交換的位置。
  • DATAEXCHANGE_ID：您要列出訂閱項目的資料交換 ID。

移除訂閱項目

主控台

  1. 在 Google Cloud 控制台中，前往「Sharing (Analytics Hub)」(分享 (數據分析中心) 頁面。

    前往「分享」(Analytics Hub)

    畫面上會顯示列出您可以存取的所有資料交換。

  2. 按一下要建立產品資訊的資料交換平台名稱。

  3. 按一下「Subscriptions」分頁標籤，查看資料交換平台的所有訂閱項目。

  4. 找出要移除的訂閱項目，然後勾選旁邊的核取方塊，或選取所有訂閱項目。

  5. 按一下「移除訂閱項目」。

API

如要移除訂閱項目，請使用 projects.locations.subscriptions.revoke 方法。

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

更改下列內容：

  • PROJECT_ID：要移除的訂閱項目專案 ID。
  • LOCATION：訂閱項目的位置。
  • SUBSCRIPTION_ID：要移除的訂閱項目 ID。

限制

訂閱方案有下列限制：

  • 系統不會補充 2023 年 7 月 25 日前建立的連結資料集。只有在 2023 年 7 月 25 日之後建立的訂閱項目才能使用 API 方法。

後續步驟