管理清單

控制台

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

啟用 Analytics Hub API

gcloud

執行 gcloud services enable 指令：

gcloud services enable analyticshub.googleapis.com

主控台

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

   前往「分享」(Analytics Hub)

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

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

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

4. 在「Configure data」(設定資料) 部分的「Resource type」(資源類型) 選單中，選取「BigQuery dataset」(BigQuery 資料集)或「Pub/Sub Topic」(Pub/Sub 主題)。

   • 如果選取「BigQuery 資料集」，請按照下列步驟操作：

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

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

        • 如要只對共用資料集的查詢結果，而非共用資料集本身套用資料外流限制，請選取「停用共用資料的複製和匯出功能」。
        • 如要對共用資料集和共用資料集的查詢結果套用資料外流限制，請選取「Disable copy and export of query results」，系統會自動設定「Disable copy and export of shared data」。
        • 如要在共用資料集上套用資料 API 複製和匯出出口限制，請選取「停用透過 API 複製及匯出資料表的功能」，系統會自動設定「停用共用資料的複製和匯出功能」。

   • 如果選取「Pub/Sub 主題」，您可以在「共用主題」選單中選取現有的 Pub/Sub 主題，或是點選「建立主題」來建立新主題。

5. 在「商店資訊」部分的「顯示名稱」中，輸入商店名稱。

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

   • 類別：選取最多兩個最能代表商家資訊的類別。訂閱者可以根據這些類別篩選房源資訊。

   • 資料相依性：發布商用於發布資料的區域。這項資訊可協助訂閱者從相同區域讀取資料，盡量降低或避免 Pub/Sub 網路輸出費用。如要進一步瞭解外流費用，請參閱「資料傳輸費用」。

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

   • 說明：簡短說明商家資訊。訂閱者可以根據說明搜尋房源資訊。

   • 公開可發現性：在 BigQuery 共用目錄中啟用公開可發現性。如果啟用這個選項，請將 Analytics Hub 檢視者角色 (roles/analyticshub.viewer) 授予 allUsers 或 allAuthenticatedUsers。詳情請參閱「授予商家資料檢視者角色」。如果廣告交易已公開，系統會繼承刊登資訊權限，因此不需要採取進一步行動。

     由於權限會沿用，公開可探索的交換服務無法擁有私人房源，但私人交換服務可以擁有公開房源。如要建立公開資訊清單，資料清單所在的專案必須有相關聯的機構和帳單帳戶。如果你要建立與 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：資料交換位置。如要進一步瞭解支援位置資訊分享功能的地區，請參閱支援的地區。
• DATAEXCHANGE_ID：資料交換 ID。
• LISTING_ID：商家資訊 ID。

在要求主體中提供商店詳細資料。如果要求成功，回應主體會包含刊登項目的詳細資料。如果啟用訂閱者電子郵件記錄功能 (預覽)，則清單回應會包含 log_linked_dataset_query_user_email: true。

如要進一步瞭解可使用 API 在產品資訊中執行的任務，請參閱 projects.locations.dataExchanges.listings 方法。

主控台

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

   前往「分享」(Analytics Hub)

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

3. 按一下要新增訂閱者的產品資訊。

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

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

6. 在「新增主體」欄位中，根據商家資訊類型加入下列詳細資料：

   • 如果是私人商家資訊，請輸入要授予存取權的使用者電子郵件 ID。

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

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

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

   • 如果是商業產品資訊，請選取「Analytics Hub Viewer」角色。這個角色可讓使用者查看商家資訊並要求存取權。

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

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

8. 按一下 [儲存]。

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 方法。

控制台

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

   前往「分享」(Analytics Hub)

2. 按一下資料交換平台名稱，該資料交換平台包含您要管理訂閱項目的商家資訊。

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

4. 如要查看所有商家資訊的訂閱者，請按一下「管理訂閱項目」。

   

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

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

1. 前往「BigQuery」頁面

   前往 BigQuery

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

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

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                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

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。

主控台

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

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

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

4. 在「Remove subscription?」對話方塊中輸入 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. 前往「分享 (Analytics Hub)」頁面。

   前往「分享」(Analytics Hub)

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

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

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

5. 修改欄位中的值。你可以修改所有值，但不包括商家資訊的來源資料集。

6. 選用：

   • 如果啟用公開可發現性，請將 Analytics Hub 檢視者角色 (roles/analyticshub.viewer) 授予 allUsers 或 allAuthenticatedUsers。詳情請參閱「授予項目的角色」。
   • 如果您停用公開可發現性，請從 allUsers 和 allAuthenticatedUsers 中移除 Analytics Hub 檢視者角色。公開交換機制無法包含私人房源，但私人交換機制可以包含公開房源。
   • 啟用電子郵件記錄功能並儲存資料後，就無法編輯這項設定。如要停用電子郵件記錄功能，請刪除清單並重新建立，但不要按一下「訂閱者電子郵件記錄」切換鈕 (預覽)。

7. 如要預覽變更內容，請按一下「預覽」。

8. 如要儲存變更，請按一下「儲存」。

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 方法。

控制台

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

   前往「分享」(Analytics Hub)

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

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

4. 按一下 delete「刪除」。

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 方法。