リスティングを管理する

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

公開アクセス権を付与されているデータエクスチェンジにリスティングを作成します。
リスティングの使用状況の指標を更新、削除、共有、表示します。
管理者、サブスクライバー、閲覧者を一覧表示するなど、Analytics Hub のリストのさまざまなロールを管理します。
リスティングに登録しているすべてのサブスクライバーを表示します。
リスティングの使用量をモニタリングします。
リスティングからサブスクライバーを削除します。

リスティングは、パブリッシャーがデータエクスチェンジに掲載する共有データセットへの参照です。リスティングには、そのリスティングに対して設定された Identity and Access Management（IAM）ポリシーと、そのリスティングを含むデータエクスチェンジの種類に基づいて、次の 2 種類があります。

公開リスティング。Google Cloud ユーザー（allAuthenticatedUsers）が検出して登録できます。一般公開データエクスチェンジのリスティングは、公開リスティングです。これらのリスティングでは、無料の一般公開データセットまたは商用データセットを参照できます。リスティングが商用データセットを参照する場合、サブスクライバーはリスティングへのアクセスをリクエストできます。データプロバイダはこれらのサブスクライバーに問い合わせます。
限定公開リスティング。個人またはグループと直接共有されます。たとえば、限定公開リスティングは、組織内の他の内部チームと共有するマーケティング指標データセットを参照できます。allAuthenticatedUsersがリスティングに登録できるようにしても、リスティングは限定公開のままになり、Analytics Hub ページで一般公開リスティングとして表示されません。このようなリスティングをユーザーと共有するには、リスティングの URL をユーザーと共有します。非公開リスティングを検出可能にするには、エクスチェンジを公開する必要があります。

始める前に

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

必要な権限

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

Cloud コンソールで API を表示する serviceUsage.services.get/list
API を有効にする serviceUsage.services.enable

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

roles/editor
roles/owner
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.publisher）。リスティングの IAM ポリシーを作成、更新、削除、設定できます。
Analytics Hub リスティング管理者のロール（roles/analyticshub.listingAdmin）。このロールでは、リスティングの IAM ポリシーを更新、削除、設定できます。
Analytics Hub 管理者ロール（roles/analyticshub.Admin）。これにより、データエクスチェンジのすべてのリスティングで IAM ポリシーを作成、更新、削除、設定できます。

詳細については、Analytics Hub のユーザーロールをご覧ください。これらのロールを他のユーザーに付与する方法については、リスティング管理者を作成するをご覧ください。

さらに、リスティングを作成するには、リスティングを作成するデータセットに対する bigquery.datasets.update 権限も付与されている必要があります。次の BigQuery の事前定義ロールには、bigquery.datasets.update 権限が含まれています。

BigQuery データのオーナーのロール（roles/bigquery.dataOwner）
BigQuery 管理者ロール（roles/bigquery.admin）

アクセスできる組織内のプロジェクト間のすべてのデータエクスチェンジを表示するには、resourcemanager.organizations.get 権限が必要です。この権限は、次の BigQuery の事前定義ロールに含まれています。

roles/browser

データエクスチェンジを表示する

アクセス可能な組織内のデータエクスチェンジの一覧を表示するには、データエクスチェンジを表示するをご覧ください。データエクスチェンジが別の組織にある場合、Analytics Hub 管理者がそのデータエクスチェンジへのリンクを共有する必要があります。

リスティングを作成する

リスティングは、パブリッシャーがデータエクスチェンジに掲載する共有デーセットへの参照です。

リスティングを作成する手順は次のとおりです。

コンソール

Analytics Hub ページに移動します。

Analytics Hub に移動

アクセス可能なすべてのデータエクスチェンジを示すページが表示されます。
リスティングを作成するデータエクスチェンジの名前をクリックします。
[リスティングを作成] をクリックします。
[リスティングを作成] ページの [表示名] に、リスティングの名前を入力します。
商用データセットを作成する場合は、[アクセスの連絡先をリクエスト] フィールドに入力する必要があります。サブスクライバーが連絡するためのメールまたは登録フォームの URL を入力する必要があります。
省略可: 次の詳細情報を入力します。
- 連絡先担当者: リスティングのメインの連絡先のメールアドレスまたは URL を入力します。
- カテゴリ: リスティングを最もよく表すカテゴリを 2 つまで選択します。サブスクライバーは、これらのカテゴリに基づいてリスティングをフィルタできます。
- プロバイダ: [プロバイダ] セクションを展開し、次のフィールドで詳細を指定します。
  - プロバイダ名: プロバイダの名前。
  - プロバイダの連絡先担当者: データセットプロバイダの連絡先担当者のメールアドレスまたは URL。
  サブスクライバーはデータプロバイダに基づいてリスティングをフィルタリングできます。
- パブリッシャー: [パブリッシャー] セクションを展開し、次のフィールドで詳細を指定します。
  - パブリッシャー名: リスティングを作成しているパブリッシャーの名前。
  - パブリッシャーの連絡先担当者: データセットパブリッシャーの連絡先担当者のメールアドレスまたは URL。
- アイコン: リスティングのアイコン。PNG と JPEG のファイル形式がサポートされています。アイコンのファイルサイズは 512 KiB 未満、サイズは 512 x 512 ピクセル以下である必要があります。
- 説明: リスティングの簡単な説明。サブスクライバーは、説明に基づいてリスティングを検索できます。
[ソースデータセット] で、データエクスチェンジに表示するデータセットを選択します。ソースデータセットは、データエクスチェンジと同じリージョンに存在する必要があります。リスティングの作成後にこのフィールドを更新することはできません。

重要: サブスクライバーがリンクされたデータセットのメタデータを表示すると、データセットを含むプロジェクトのソースデータセット名と ID が返されます。
[下り（外向き）データ]（プレビュー）で、適切な下り（外向き）データオプションを選択します。エディション以外のサービスまたは Enterprise Plus エディションのサブスクライバーのみが、下り（外向き）データの制限があるデータをクエリできます。
- 共有データセットにデータ下り（外向き）制限を適用し、共有データセットのクエリ結果には適用しない場合は、[共有データのコピーとエクスポートを無効にする] を選択します。
- 共有データセットと共有データセットのクエリ結果に下り（外向き）制限を適用するには、[クエリ結果のコピーとエクスポートを無効にする] を選択します。これにより、[共有データのコピーとエクスポートを無効にする] も自動的に設定されます。
オプション: [ドキュメント] > [マークダウン] セクションでは、データセットで実行できるサンプルクエリや、関連するドキュメントへのリンク、およびサブスクライバーがデータセットを使用するために役立つその他の情報など、追加情報を入力できます。
[保存] をクリックします。

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: データエクスチェンジのロケーション。Analytics Hub をサポートするロケーションの詳細については、サポート対象のリージョンをご覧ください。
DATAEXCHANGE_ID: データエクスチェンジ ID。
LISTING_ID: リスティング ID。

リクエストの本文で、リスティングの詳細を指定します。リクエストが成功した場合は、レスポンスの本文にリスティングの詳細が含まれます。

API を使用してリスティングに対して実行できるタスクの詳細については、projects.locations.dataExchanges.listings メソッドをご覧ください。

リスティングへのアクセス権をユーザーに付与する

ユーザーに非公開リスティングへのアクセスを許可する場合は、そのリスティングに対する個人またはグループの IAM ポリシーを設定する必要があります。商用リスティングの場合、データエクスチェンジを公開する必要があります。一般公開データエクスチェンジのリスティングが、すべての Google Cloud ユーザー（allAuthenticatedUsers）のアナリティクスハブに表示されます。ユーザーが商用リスティングへのアクセス権をリクエストできるようにするには、Analytics Hub 閲覧者のロールをご覧ください。

ユーザーにリスティングの閲覧や登録のアクセス権を与えるには、以下の手順を実施します。

コンソール

Analytics Hub ページに移動します。

Analytics Hub に移動
リスティングを含むデータエクスチェンジ名をクリックします。
サブスクライバーを追加するリスティングをクリックします。
[権限を設定] をクリックします。
プリンシパルを追加するには、 [プリンシパルを追加] をクリックします。
[新しいプリンシパル] フィールドに、リスティングの種類に基づいて次の詳細情報を追加します。
- 限定公開リスティングの場合は、アクセス権を付与する ID のメールアドレスを入力します。
- 公開リスティングの場合は、allAuthenticatedUsers を追加します。
[ロールを選択] で、[Analytics Hub] の上にポインタを置き、リスティングの種類に基づいて、次のいずれかのロールを選択します。
- 商用リスティングの場合は、Analytics Hub 閲覧者のロールを選択します。このロールにより、ユーザーはリスティングを表示してアクセス権をリクエストできます。
- 限定公開または商用以外のリスティングの場合は、Analytics Hub サブスクライバーのロールを選択します。このロールにより、ユーザーはリスティングに登録できます。
詳しくは、Analytics Hub のサブスクライバーと閲覧者のロールをご覧ください。
[保存] をクリックします。

API

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。
Analytics Hub は、レスポンスで現在のポリシーを返します。
メンバーとそれに関連するロールを追加または削除するには、テキストエディタでポリシーを編集します。メンバーを追加するには、次の形式を使用します。
- 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"
}
```
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 メソッドをご覧ください。

リスティング管理者を作成する

ユーザーがリスティングを管理できるようにするには、Analytics Hub のリスティング管理者を作成する必要があります。リスティング管理者を作成するには、リスティングレベルで Analytics Hub パブリッシャーまたは Analytics Hub リスティング管理者のロールをユーザーに付与する必要があります。リスティングに対するこれらのロールを付与する方法については、リスティングに対するロールを付与するをご覧ください。

サブスクリプションをすべて見る

リスティングへの現在のすべてのサブスクリプションを表示するには、次のいずれかのオプションを選択します。

コンソール

Analytics Hub ページに移動します。

Analytics Hub に移動
サブスクリプションを管理するリスティングを含むデータエクスチェンジ名をクリックします。
すべてのサブスクライバーを一覧表示するリスティングをクリックします。
リスティングのすべてのサブスクライバーを表示するには、[サブスクリプションを管理] をクリックします。
省略可: サブスクライバーの詳細で結果をフィルタできます。

また、共有データセットにアクセスできる場合は、次の手順でサブスクライバーを一覧表示します。

[BigQuery] ページに移動します。

[BigQuery] に移動
[エクスプローラ] ペインでプロジェクトを開き、共有データセットを選択します。
[共有] リストで、[サブスクリプションを管理] を選択します。

SQL

次の例では、INFORMATION_SCHEMA.SCHEMATA_LINKS ビューを使用して、us リージョンにある myproject の共有データセットにリンクされているすべてのデータセットを一覧表示します。

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。

サブスクリプションを削除する

2023 年 7 月 25 日より前に作成されたサブスクリプションをリスティングから削除すると、リンクされたデータセットは共有データセットからリンク解除されます。サブスクライバーは自分のプロジェクト内のデータセットを表示できますが、共有データセットにリンクされなくなります。

2023 年 7 月 25 日より前に作成されたサブスクリプションをリスティングから削除する手順は次のとおりです。

リスティングのすべてのサブスクライバーを一覧表示するには、すべてのサブスクリプションを表示するに記載されている Google Cloud コンソールの手順を実施します。
リスティングからサブスクライバーを削除するには、 [削除] をクリックします。すべてのサブスクリプションを削除するには、[すべてのサブスクリプションを削除] をクリックします。
[サブスクリプションを削除しますか？] ダイアログに「remove」と入力して確定します。
[削除] をクリックします。

2023 年 7 月 25 日以降に作成されたサブスクリプションを削除する手順は次のとおりです。

コンソール

リスティングのすべてのサブスクライバーを一覧表示するには、すべてのサブスクリプションを表示するに記載されている Google Cloud コンソールの手順を実施します。
[サブスクリプション] タブをクリックします。
リスティングからサブスクライバーを削除するには、削除するサブスクリプションを選択し、 [サブスクリプションを削除] をクリックします。
[サブスクリプションを削除しますか？] ダイアログに「remove」と入力して確定します。
[削除] をクリックします。

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。

リスティングを更新する

リスティングを更新する方法は次のとおりです。

コンソール

Analytics Hub ページに移動します。

Analytics Hub に移動
リスティングを含むデータエクスチェンジ名をクリックします。
更新するリスティングをクリックします。
[リスティングを編集] をクリックします。
フィールドの値を変更します。リスティングのソースデータセットを除くすべての値を変更できます。
変更内容をプレビューするには、[プレビュー] をクリックします。
変更を保存するには、[保存] をクリックします。

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 メソッドをご覧ください。

リスティングを削除する

サブスクリプションを削除すると、サブスクライバーはそのサブスクリプションを表示できなくなります。ただし、リストを削除しても、サブスクライバーのプロジェクトからリンクされたデータセットは削除されません。データへのすべてのアクセス権を削除するには、次のいずれかのオプションを選択する必要があります。

共有データセットを削除する
共有データセットにリンクされたすべてのデータセットを削除する

リスティングを削除した場合、元に戻すことはできません。リスティングの削除方法は次のとおりです。

コンソール

Analytics Hub ページに移動します。

Analytics Hub に移動
リスティングを含むデータエクスチェンジ名をクリックします。
削除するリスティングをクリックします。
[削除] をクリックします。
[エクスチェンジを削除しますか？] ダイアログで「削除」と入力して削除を確定します。
[削除] をクリックします。

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 メソッドをご覧ください。

次のステップ

Analytics Hub アーキテクチャについて読む
リスティングを表示して登録する方法について詳細を確認する。
Analytics Hub のユーザーロールについて確認する。
データセットの作成について確認する。
Analytics Hub の監査ロギングについて確認する。
詳しくは、リスティングをモニタリングする方法をご覧ください。

リスティングを管理する

始める前に

必要な権限

Analytics Hub API を有効にする

コンソール

gcloud

必要な権限

データ エクスチェンジを表示する

リスティングを作成する

コンソール

API

リスティングへのアクセス権をユーザーに付与する

コンソール

API

リスティング管理者を作成する

サブスクリプションをすべて見る

コンソール

SQL

API

サブスクリプションを削除する

コンソール

API

リスティングを更新する

コンソール

API

リスティングを削除する

コンソール

API

次のステップ

データエクスチェンジを表示する