サブスクリプションを管理する

Analytics Hub サブスクライバーは、次の操作を行うことができます。

  • リスティングをサブスクライブする。
  • 特定のプロジェクトの現在のサブスクリプションを一覧表示する。
  • サブスクリプションを削除する。

Analytics Hub のパブリッシャーは、次の操作を行うことができます。

  • リスティングのすべてのサブスクリプションを表示する。
  • 特定のサブスクリプションへのアクセスを取り消す。

サブスクリプションは、サブスクライバーのプロジェクトに存在するリージョン リソースです。サブスクリプションには、サブスクライバーに関する関連情報が保存され、パブリッシャーとサブスクライバーの間の契約を表します。

始める前に

Analytics Hub を開始するには、Google Cloud プロジェクト内で Analytics Hub API を有効にする必要があります。

必要な権限

Analytics Hub API を有効にするには、次の Identity and Access Management（IAM）権限が必要です。

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

次の IAM 事前定義ロールには、Analytics Hub API を有効にするために必要な権限が含まれています。

  • roles/serviceusage.serviceUsageAdmin

BigQuery での IAM のロールの詳細については、事前定義ロールと権限をご覧ください。

Analytics Hub API を有効にする

Analytics Hub API を有効にする方法は次のとおりです。

コンソール

Google Cloud プロジェクトの Analytics Hub API に移動して有効にします。

Analytics Hub API を有効にする

gcloud

gcloud services enable コマンドを実行します。

gcloud services enable analyticshub.googleapis.com

必要な権限

サブスクリプションを管理するには、次のいずれかの Analytics Hub ロールが付与されている必要があります。

  • Analytics Hub サブスクリプション オーナーのロール（roles/analyticshub.subscriptionOwner）。これにより、作成したサブスクリプションを管理できます。

詳細については、Analytics Hub のユーザーロールをご覧ください。

サブスクライバーのワークフロー

サブスクライバーは、サブスクリプションで次の操作を行うことができます。

リスティングをサブスクライブする

リスティングをサブスクライブするには、リスティングに登録するの手順を実施してください。

サブスクリプションの一覧表示

すべてのサブスクリプションを一覧表示する手順は次のとおりです。

API

特定のプロジェクトの現在のサブスクリプションを表示するには、projects.locations.subscriptions.list メソッドを使用します。

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

次のように置き換えます。

  • PROJECT_ID: 一覧表示するサブスクリプションを含むプロジェクト ID。

  • LOCATION: 既存のサブスクリプションを一覧表示するロケーション。

パブリッシャーのワークフロー

パブリッシャーは、サブスクリプションで次の操作を行うことができます。リスティングのサブスクリプションの管理について詳しくは、リスティングの管理をご覧ください。

サブスクリプションの一覧表示

すべてのサブスクリプションを一覧表示する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[Analytics Hub] ページに移動します。

    Analytics Hub に移動

    アクセス可能なすべてのデータ エクスチェンジを示すページが表示されます。

  2. サブスクリプションを一覧表示するデータ エクスチェンジの名前をクリックします。

  3. [サブスクリプション] タブをクリックします。データ エクスチェンジ内のリスティングのサブスクリプションがすべて表示されます。

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 コンソールで、[Analytics Hub] ページに移動します。

    Analytics Hub に移動

    アクセス可能なすべてのデータ エクスチェンジを示すページが表示されます。

  2. リスティングを作成するデータ エクスチェンジの名前をクリックします。

  3. [サブスクリプション] タブをクリックします。データ エクスチェンジのすべてのサブスクリプションが表示されます。

  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 メソッドで機能します。

次のステップ