管理清單

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

  • 在您有發布權限的資料交易平台中建立房源資訊。
  • 更新、刪除、分享及查看房源的使用指標。
  • 管理 BigQuery sharing (舊稱 Analytics Hub) 項目不同角色，例如項目管理員、訂閱者和檢視者。
  • 查看所有訂閱你商家資訊的訂閱者。
  • 監控商家資訊的使用情況。
  • 從房源資訊中移除訂閱者。

清單是發布者在資料交換庫中列出的共用資料集參照資訊。根據為商家資訊設定的身分與存取權管理 (IAM) 政策，以及包含商家資訊的資料交換類型，商家資訊可分為下列兩種：

事前準備

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

所需權限

如要啟用 Analytics Hub API，您需要下列 Identity and Access Management (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 頁面，為專案啟用 Analytics Hub API。 Google Cloud

啟用 Analytics Hub API

gcloud

執行 gcloud services enable 指令：

gcloud services enable analyticshub.googleapis.com

所需權限

如要管理商家資訊和訂閱項目，您必須具備下列其中一個 Analytics Hub 角色：

  • Analytics Hub 發布者角色 (roles/analyticshub.publisher)：可建立、更新、刪除及設定項目 IAM 政策。

  • Analytics Hub 項目管理員角色 (roles/analyticshub.listingAdmin)，可讓您更新、刪除項目，以及設定項目的 IAM 政策。

  • Analytics Hub 管理員角色 (roles/analyticshub.Admin)：可建立、更新、刪除及設定資料交換中所有項目的 IAM 政策。

詳情請參閱「Analytics Hub 使用者角色」。 如要瞭解如何將這些角色授予其他使用者，請參閱「建立房源管理員」。

此外，如要建立項目，您也必須具備要建立項目之資料集的 bigquery.datasets.get 和 bigquery.datasets.update 權限。下列 BigQuery 預先定義的角色具備 bigquery.datasets.update 權限：

  • BigQuery 資料擁有者角色 (roles/bigquery.dataOwner)
  • BigQuery 管理員角色 (roles/bigquery.admin)

如要查看您有權存取的機構內所有專案的資料交換，您必須具備 resourcemanager.organizations.get 權限。沒有包含這項權限的 BigQuery 預先定義角色，因此您需要使用 IAM 自訂角色。

查看資料交換庫

如要查看您有權存取的機構資料交易平台清單，請參閱「查看資料交易平台」。如果資料交換服務位於其他機構，Analytics Hub 管理員必須與您共用該資料交換服務的連結。

建立商家資訊

清單是發布者在資料交換庫中列出的共用資料集參照資訊。

如要建立商家資訊，請按照下列步驟操作：

主控台

  1. 前往「Sharing (Analytics Hub)」頁面。

    前往「共用」(Analytics Hub)

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

  2. 按一下要建立房源資訊的資料交易所名稱。

  3. 按一下 「建立商店資訊」。

  4. 在「設定資料」部分，從「資源類型」選單中，選取「BigQuery 資料集」或「Pub/Sub 主題」。

    • 如果選取「BigQuery 資料集」，請執行下列操作：

      1. 在「共用資料集」選單中，選取現有資料集，或按一下「建立資料集」建立新資料集。選取要在資料交換中列出的資料集。資料集必須與資料交換位於相同區域。建立房源資訊後，就無法更新這個欄位。訂閱者查看連結資料集的中繼資料時，系統會傳回來源資料集名稱和資料集所屬專案的 ID。

      2. 展開「區域資料可用性」選單 (預覽)，在其他區域提供共用資料集。選單會顯示有資料集副本的區域，並標示「可供使用」。設定多個區域的項目之前，請先確認您已在共用資料集上啟用跨區域資料集複製，因為您只能選取已啟用跨區域資料集複製的區域。其他地區則標示為「不適用」。如未選取其他區域，項目預設會使用共用資料集的主要區域，標示為「供應商主要區域」。

      3. 在「資料輸出控制項」中，選取適當的資料輸出選項。

        • 如要對共用資料集套用資料外流限制，但不要對共用資料集的查詢結果套用限制，請選取「停用共用資料的複製和匯出功能」。
        • 如要對共用資料集和共用資料集的查詢結果套用資料外流限制，請選取「禁止複製及匯出查詢結果」，系統也會自動設定「禁止複製及匯出共用資料」。
        • 如要對共用資料集套用資料 API 複製和匯出輸出限制，請選取「停用透過 API 複製及匯出資料表的功能」，系統會自動一併設定「停用共用資料複製與匯出功能」。

    • 如果選取「Pub/Sub Topic」(Pub/Sub 主題)，則可以在「Shared topic」(共用主題) 選單中選取現有的 Pub/Sub 主題，或按一下「Create a topic」(建立主題) 建立新主題。

  5. 在「應用程式詳細資訊」部分的「顯示名稱」中，輸入商店資訊的名稱。

  6. 輸入下列選填詳細資料：

    • 類別：選取最多兩個最符合商家檔案的類別。訂閱者可以根據這些類別篩選商品。

    • 資料親和性：如果您使用 Pub/Sub 主題，發布者用於發布資料的區域。訂閱者可從相同區域讀取資料，藉此盡量減少或避免 Pub/Sub 網路輸出費用。如要進一步瞭解輸出費用，請參閱「資料移轉費用」。

    • 圖示：商店資訊的圖示。支援 PNG 和 JPEG 檔案格式。圖示的檔案大小不得超過 512 KiB，且尺寸不得超過 512 x 512 像素。

    • 說明：簡要說明房源。訂閱者可以根據說明搜尋房源。

    • 公開探索：在 BigQuery 共用目錄中啟用公開探索功能，啟用這個選項後，請授予 allUsers 或 allAuthenticatedUsers Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。詳情請參閱「授予房源角色」。如果交易所已公開，系統會自動沿用上架權限，因此不需要採取任何行動。

      由於權限繼承的關係，公開可探索的交易平台無法提供私人刊登，但私人交易平台可以提供公開刊登。如要建立公開資料，資料目錄所在的專案必須有相關聯的機構和帳單帳戶。如果您要建立整合 Cloud Marketplace 的商業產品資訊，建議將產品資訊設為公開，方便使用者搜尋。

    • 說明文件 > Markdown：其他資訊，例如任何相關說明文件的連結，以及有助於訂閱者使用主題的任何其他資訊。

  7. 在「商店資訊聯絡資料」部分，輸入下列選填詳細資料：

    • 主要聯絡人：輸入商家資訊主要聯絡人的電子郵件 ID 或網址。

    • 要求存取權聯絡人：輸入電子郵件 ID 或訂閱者與您聯絡的申請表單網址。

    • 供應商：展開「供應商」部分，並在下列欄位中指定詳細資料：

      • 供應商名稱：主題供應商的名稱。
      • 供應商主要聯絡人：主題供應商主要聯絡人的電子郵件 ID 或網址。

      訂閱者可以根據資料供應商篩選清單。

    • 發布商：展開「發布商」部分，並在下列欄位中指定詳細資料：

      • 發布商名稱：建立商家資訊的發布商名稱。
      • 發布者主要聯絡人：主題發布者主要聯絡人的電子郵件 ID 或網址。

  8. 查看「商家資訊預覽」部分。

  9. 按一下 [發布]。

API

請使用 projects.locations.dataExchanges.listings.create 方法。

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

更改下列內容：

  • PROJECT_ID：專案 ID，用於存放您要建立資訊的資料交易所。
  • LOCATION：資料交換的位置。如要進一步瞭解支援 BigQuery sharing 的位置，請參閱支援的區域。
  • DATAEXCHANGE_ID：資料交易平台 ID。
  • LISTING_ID：房源 ID。

在要求主體中，提供房源詳細資料。

如要為多個區域建立商家資訊 (預覽版)，請在要求主體的 bigqueryDataset.replicaLocations 欄位中指定其他區域。為多個區域設定共用資料集之前，請先確認已在共用資料集上啟用跨區域資料集複製。您只能選取已啟用跨區域資料集複製功能的區域。如果未填寫這個選填欄位，系統會使用共用資料集的主要區域建立房源資訊。

如果要求成功，回應主體會包含房源詳細資料。如果啟用訂閱者電子郵件記錄功能 (搶先版)，清單回應會包含 log_linked_dataset_query_user_email: true。

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

從資料集建立房源資訊

你也可以透過資料集建立房源資訊，方法如下：

  1. 前往 Google Cloud 控制台的「BigQuery」頁面。

    前往 BigQuery

  2. 按一下資料集即可查看詳細資料。

  3. 依序按一下「分享」>「發布為房源資訊」。

    系統會開啟「建立商家資訊」對話方塊。

  4. 選取要發布這項清單的資料交換庫。資料交易所必須與資料集位於相同區域。如要進一步瞭解如何建立資料交換，請參閱建立交換並設定權限。

  5. 在「共用資料集」選單中，選取現有資料集，或按一下「建立資料集」建立新資料集。選取要在資料交換中列出的資料集。資料集必須與資料交換位於相同區域。房源建立後，就無法更新這個欄位。

    訂閱者查看連結資料集的中繼資料時，系統會傳回來源資料集名稱和資料集所屬專案的 ID。

  6. 展開「區域資料可用性」選單 (預覽)，在其他區域提供共用資料集。選單會顯示有資料集副本的區域，並標示「可供使用」。設定多個區域的項目之前，請先確認您已在共用資料集上啟用跨區域資料集複製，因為您只能選取已啟用跨區域資料集複製的區域。其他地區則標示為「不適用」。如未選取其他區域，預設會使用共用資料集區域，標示為「供應商主要區域」。

  7. 在「資料外流控制項」中，選取適當的「資料外流」選項。

    • 如要對共用資料集套用資料輸出限制，但不要對共用資料集的查詢結果套用限制，請選取「停用共用資料複製與匯出功能」。
    • 如要對共用資料集和共用資料集的查詢結果套用資料輸出限制，請選取「停用查詢結果複製與匯出功能」，系統也會自動設定「停用共用資料複製與匯出功能」。
    • 如要對共用資料集套用資料 API 複製和匯出輸出限制，請選取「停用透過 API 複製及匯出資料表的功能」，系統也會自動設定「停用共用資料複製與匯出功能」。

  8. 在「應用程式詳細資訊」部分的「顯示名稱」中，輸入商店資訊的名稱。

  9. 輸入下列選填詳細資料：

    • 類別：選取最多兩個最符合商家檔案的類別。訂閱者可以根據這些類別篩選房源。

    • 資料相依性：發布商用來發布資料的區域。訂閱者可利用這項資訊，從相同區域讀取資料，盡量減少或避免產生 Pub/Sub 網路輸出費用。如要進一步瞭解輸出費用，請參閱「資料移轉費用」。

    • 圖示：商店資訊的圖示。支援 PNG 和 JPEG 檔案格式。圖示的檔案大小不得超過 512 KiB，且尺寸不得超過 512 x 512 像素。

    • 說明：簡要說明房源。訂閱者可以根據說明搜尋房源。

    • 公開探索：在 BigQuery 共用目錄中啟用公開探索功能，啟用這個選項後，請授予 allUsers 或 allAuthenticatedUsers Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。詳情請參閱「授予房源角色」。如果交易所已公開，系統會自動沿用上架權限，因此不需要採取任何行動。

      由於權限繼承的關係，公開可探索的交易平台無法提供私人刊登，但私人交易平台可以提供公開刊登。如要建立公開資料，資料目錄所在的專案必須有相關聯的機構和帳單帳戶。如果您要建立整合 Cloud Marketplace 的商業產品資訊，建議將產品資訊設為公開，方便使用者搜尋。

    • 記錄訂閱端電子郵件：記錄訂閱端使用者電子郵件，以便掌握此清單項目的連結資料集使用情形。啟用並儲存電子郵件記錄功能後，這項設定就無法編輯。如要停用電子郵件記錄功能，請刪除清單項目，然後重新建立，但不要點選「訂閱端電子郵件記錄」切換鈕 (預覽)。

    • 說明文件 > Markdown：其他資訊，例如任何相關說明文件的連結，以及有助於訂閱者使用主題的任何其他資訊。

  10. 在「商店資訊聯絡資料」部分，輸入下列選填詳細資料：

    • 主要聯絡人：輸入商家資訊主要聯絡人的電子郵件 ID 或網址。

    • 要求存取權聯絡人：輸入電子郵件 ID 或訂閱者可聯絡你的申請表單網址。

    • 供應商：展開「供應商」部分，並在下列欄位中指定詳細資料：

      • 供應商名稱：主題供應商的名稱。
      • 供應商主要聯絡人：主題供應商主要聯絡人的電子郵件 ID 或網址。

      訂閱者可以根據資料供應商篩選清單。

    • 發布商：展開「發布商」部分，並在下列欄位中指定詳細資料：

      • 發布商名稱：建立商家資訊的發布商名稱。
      • 發布者主要聯絡人：主題發布者主要聯絡人的電子郵件 ID 或網址。

  11. 查看「商家資訊預覽」部分。

  12. 按一下 [發布]。

授予使用者商家資訊存取權

如要授權使用者存取私人項目，請為該項目設定個別使用者或群組的 IAM 政策。如果是商業用途，資料交換必須公開。公開資料交易所中的項目會顯示在所有Google Cloud 使用者 (allAuthenticatedUsers) 的 BigQuery sharing 中。如要讓使用者瀏覽及要求存取商業項目，您必須授予使用者 Analytics Hub 檢視者角色。如要讓使用者訂閱商業產品資訊，您必須明確授予使用者 Analytics Hub 訂閱者角色。如果是已整合 Cloud Marketplace 的商業產品資訊，系統會根據 Cloud Marketplace 訂單自動佈建 Analytics Hub 訂閱者角色。

如要讓所有人 (包括未使用 Google Cloud的使用者) 都能存取服務清單，請授予 allUsers Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。

如要授予使用者查看或訂閱房源的權限，請按照下列步驟操作：

主控台

  1. 前往「Sharing (Analytics Hub)」頁面。

    前往「共用」(Analytics Hub)

  2. 按一下包含商家資訊的資料交易所名稱。

  3. 按一下要新增訂閱者的房源資訊。

  4. 按一下「設定權限」。

  5. 如要新增主體，請按一下 「新增主體」。

  6. 在「New principals」(新增主體) 欄位中，根據房源類型新增下列詳細資料：

    • 如果是私人房源，請輸入要授予存取權的身分識別電子郵件 ID。

    • 如果是公開資訊，請新增 allAuthenticatedUsers。

    • 如要讓所有人 (包括非Google Cloud使用者) 都能找到公開的產品資訊，請新增 allUsers。

  7. 在「選取角色」部分，將指標懸停在「Analytics Hub」上，然後根據項目類型選取下列其中一個角色：

    • 如果是商業產品資訊 (包括整合 Cloud Marketplace 的產品資訊)，請選取「Analytics Hub Viewer」角色。使用者可透過這個角色查看商家檔案並要求存取權。

    • 如果是私人或非商業用途的公開清單，請選取「Analytics Hub 訂閱者」角色。使用者可透過這個角色訂閱你的商家資訊。

    • 如果是整合 Cloud Marketplace 的項目，系統會根據 Cloud Marketplace 訂單自動管理訂閱項目，因此不需要授予 Analytics Hub 訂閱者角色。

    詳情請參閱「Analytics Hub 訂閱者和檢視者角色」。

  8. 按一下 [儲存]。

    詳情請參閱「Analytics Hub 訂閱者和檢視者角色」。

  9. 按一下 [儲存]。

API

  1. 使用 projects.locations.dataExchanges.listings.getIamPolicy 方法，透過清單 getIamPolicy 方法讀取現有政策。

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy

    更改下列內容：

    • PROJECT_ID：專案 ID，例如 my-project-1。
    • LOCATION：含有房源資訊的資料交易所位置。
    • DATAEXCHANGE_ID：資料交易平台 ID。
    • LISTING_ID：房源 ID。

    分享會在回應中傳回目前的政策。

  2. 如要新增或移除成員及其相關聯的角色，請使用文字編輯器編輯政策。請使用下列格式新增成員：

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    舉例來說，如要將 roles/analyticshub.subscriber 角色授予 group:subscribers@example.com，請在政策中新增下列繫結：

    {
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}

  3. 使用 projects.locations.dataExchanges.listings.setIamPolicy 方法寫入更新後的政策。在要求主體中，提供上一個步驟中更新的 IAM 政策。

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy

    在要求主體中提供房源詳細資料。如果要求成功，回應主體會包含房源詳細資料。

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

為公開房源建立未經驗證的網址

如要建立未經驗證的 BigQuery 共用項目網址，讓非Google Cloud 使用者也能查看，請按照下列步驟操作：

  1. 前往「Sharing (Analytics Hub)」頁面。

    前往「共用」(Analytics Hub)

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

  2. 按一下包含商家資訊的資料交易所名稱。

  3. 按一下顯示名稱即可查看房源詳細資料。商店資訊必須啟用公開探索功能。

  4. 按一下「複製公開連結」，即可產生未經驗證的產品資訊網址。請確認這個項目授予 allUsers Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。

建立商店資訊管理員

如要讓使用者管理房源資訊，必須建立房源資訊管理員。如要建立清單管理員，您必須在清單層級授予使用者Analytics Hub 發布者或 Analytics Hub 清單管理員角色。如要進一步瞭解如何授予這些角色，請參閱授予房源角色。

查看所有訂閱項目

如要查看目前所有商店資訊的訂閱項目，請選取下列其中一個選項：

控制台

  1. 前往「Sharing (Analytics Hub)」頁面。

    前往「共用」(Analytics Hub)

  2. 按一下包含要管理訂閱項目商家資訊的資料交易名稱。

  3. 按一下要列出所有訂閱者的商家資訊。

  4. 如要查看所有訂閱者，請按一下「管理訂閱」。

    管理訂閱者

  5. 選用：您可以依訂閱者詳細資料篩選結果。

或者，如果您有權存取共用資料集，可以按照下列步驟列出訂閱者：

  1. 前往「BigQuery」頁面

    前往「BigQuery」

  2. 在「Explorer」窗格中展開專案，然後選取共用資料集。

  3. 在「分享」清單中，選取「管理訂閱項目」。

SQL

以下範例會使用 INFORMATION_SCHEMA.SCHEMATA_LINKS 檢視區塊，列出 myproject 中連結至共用資料集的所有連結資料集，這些資料集位於 us 區域：

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

輸出結果大致如下。某些資料欄會省略，用以簡化輸出內容。

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

如要查看多個區域的訂閱項目 (預覽)，請將 us 區域替換為預期副本位置，即可查看不同區域的訂閱項目。舉例來說，如要查看 myproject 中連結至共用資料集且位於 eu 區域的連結資料集，請使用下列查詢：

SELECT * FROM `myproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

API

使用 projects.locations.dataExchanges.listings.listSubscriptions 方法。

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

更改下列內容：

  • PROJECT_ID：要訂閱的房源專案 ID。
  • LOCATION：要訂閱的商家資訊位置。
  • DATAEXCHANGE_ID：包含您要訂閱的房源資訊的資料交易所 ID。
  • LISTING_ID：要訂閱的房源 ID。

移除訂閱項目

如果移除 2023 年 7 月 25 日前建立的訂閱項目，連結的資料集會與共用資料集取消連結。訂閱者仍可在專案中查看資料集，但這些資料集已不再連結至共用資料集。

如要從商店資訊中移除 2023 年 7 月 25 日前建立的訂閱項目，請按照下列步驟操作：

  1. 如要列出所有訂閱者，請按照「查看所有訂閱項目」一文中的 Google Cloud 控制台操作說明進行操作。

  2. 如要從清單中移除訂閱者，請按一下「刪除」。如要移除所有訂閱項目，請按一下「移除所有訂閱項目」。

  3. 在「要移除訂閱項目嗎？」對話方塊中輸入 remove 以確認。

  4. 按一下 [移除]。

如要移除 2023 年 7 月 25 日後建立的訂閱項目，請按照下列步驟操作：

主控台

  1. 如要列出所有訂閱者，請按照「查看所有訂閱項目」一文中的 Google Cloud 控制台操作說明進行操作。

  2. 按一下「Subscriptions」(訂閱項目) 分頁標籤。

  3. 如要從房源資訊中移除訂閱者，請選取要移除的訂閱項目，然後按一下 「移除訂閱項目」。

  4. 在「要移除訂閱項目嗎？」對話方塊中輸入 remove 以確認。

  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。

更新產品資訊

如要更新房源資訊，請按照下列步驟操作：

主控台

  1. 前往「Sharing (Analytics Hub)」頁面。

    前往「共用」(Analytics Hub)

  2. 按一下包含商家資訊的資料交易所名稱。

  3. 按一下要更新的商家資訊。

  4. 按一下「編輯商家資訊」。

  5. 修改欄位中的值。除了房源的來源資料集，你還可以修改所有值。

  6. 選用：

    • 如要啟用公開探索功能，請授予 allUsers 或 allAuthenticatedUsers Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。詳情請參閱授予項目的角色
    • 如果停用公開探索功能，請從 allUsers 和 allAuthenticatedUsers 移除 Analytics Hub 檢視者角色。公開交易平台無法提供私人房源，但私人交易平台可以提供公開房源。
    • 啟用並儲存訂閱端電子郵件記錄功能後，就無法編輯這項設定。如要停用電子郵件記錄功能，請刪除清單項目並重新建立，但不要點選「訂閱端電子郵件記錄」切換按鈕 (預覽)。
    • 在商家資訊中新增或移除區域 (預覽)。 新增多個區域前，請先確認您已在共用資料集上啟用跨區域資料集複製。移除區域時，請先刪除該區域中的共用資料集副本。

  7. 預覽房源資訊。

  8. 如要儲存變更，請按一下「儲存」。為避免與整合 Cloud Marketplace 的產品資訊發生差異，系統會顯示通知，提示更新 Cloud Marketplace 資料產品資訊。

API

請使用 projects.locations.dataExchanges.listings.patch 方法。

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

將 UPDATEMASK 替換為要更新的欄位清單。如要更新多個值，請使用以半形逗號分隔的清單。在要求主體中，指定更新後的值。

在要求主體中，為下列欄位指定更新後的值：

  • 顯示名稱
  • 說明
  • 類別
  • 說明文件
  • 圖示
  • 主要聯絡人
  • 開放搜尋
  • 訂閱端電子郵件記錄功能 (預覽版)

如要進一步瞭解這些欄位，請參閱「資源：房源」。

更新應用程式副本的區域時，請務必指定所有適用區域。更新商家資訊前，請確認已在共用資料集上啟用跨區域資料集複製。您只能新增共用資料集複製所在的區域 (預覽版)。如要移除區域，請先刪除該區域的共用資料集副本，再從商家資訊中移除。只有新建立的多個區域房源，才能更新備用區域。你無法將現有商家資訊轉換為多個區域的商家資訊。

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

刪除商家資訊

刪除商品後，訂閱者就無法再查看商品。刪除房源也會刪除所有連結的資料集，並從訂閱者的專案中移除所有訂閱項目。如果資料集仍處於連結狀態，請按一下 依序點選「共用」>「管理訂閱」，手動移除資料集。系統會開啟「訂閱項目」頁面，您可以在這裡移除特定訂閱者資料集，或一次移除所有訂閱者資料集。

您無法刪除含有有效商業訂閱項目的整合 Cloud Marketplace 的產品資訊。刪除房源前，請撤銷所有商業訂閱。

刪除多個區域的商家資訊 (預先發布版) 不會刪除共用資料集副本。刪除多個區域的項目後，訂閱者就無法再查看項目或查詢連結的資料集。如果其他房源未參照共用資料集副本，您可以選擇刪除副本。

刪除多個區域的商家資訊 (預覽) 前，請確認沒有與其相關聯的有效訂閱項目。如有有效訂閱項目，請先使用 projects.locations.subscriptions.revoke 方法撤銷訂閱。移除所有有效訂閱後，即可繼續刪除多個區域的商家資訊。

如要刪除房源，請按照下列步驟操作：

控制台

  1. 前往「Sharing (Analytics Hub)」頁面。

    前往「共用」(Analytics Hub)

  2. 按一下包含商家資訊的資料交易所名稱。

  3. 按一下要刪除的商家資訊。

  4. 按一下「刪除」圖示 。

  5. 在「Delete listing?」(要刪除房源嗎？) 對話方塊中輸入「delete」(刪除)，確認要刪除房源。

  6. 點選「刪除」。

API

請使用 projects.locations.dataExchanges.listings.delete 方法。

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

如要提高 BigQuery 共用目錄中資源的曝光率和知名度，資源可以顯示在「精選」部分。精選房源受《 Google Cloud 優勢合作夥伴協議》規範。

如要讓合作夥伴的清單顯示在 BigQuery 共用目錄的「精選」部分，必須符合下列條件：

如要申請將商家資訊加入「精選」專區，請填寫並提交申請表單。如要要求從該專區移除商家資訊，請提交相同的申請表單。

後續步驟