Kelola langganan

Sebagai pelanggan Analytics Hub, Anda dapat melakukan hal-hal berikut:

  • Berlangganan listingan.
  • Mencantumkan langganan Anda saat ini dalam project tertentu.
  • Menghapus langganan.

Sebagai penayang Analytics Hub, Anda dapat melakukan tugas berikut:

  • Melihat semua langganan ke listingan Anda.
  • Mencabut akses ke langganan tertentu.

Langganan adalah resource regional yang berada dalam project pelanggan. Langganan menyimpan informasi yang relevan tentang pelanggan dan mewakili kontrak antara penerbit dan penayang.

Sebelum memulai

Untuk mulai menggunakan berbagi BigQuery (sebelumnya Analytics Hub), Anda harus mengaktifkan Analytics Hub API di dalam project Google Cloud .

Izin yang diperlukan

Untuk mengaktifkan Analytics Hub API, Anda memerlukan izin Identity and Access Management (IAM) berikut:

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

Peran IAM bawaan berikut mencakup izin yang diperlukan untuk mengaktifkan Analytics Hub API:

  • roles/serviceusage.serviceUsageAdmin

Untuk mengetahui informasi selengkapnya tentang peran IAM di BigQuery, lihat Peran dan izin yang telah ditentukan sebelumnya.

Mengaktifkan Analytics Hub API

Untuk mengaktifkan Analytics Hub API, lakukan tindakan berikut:

Konsol

Buka halaman Analytics Hub API dan aktifkan Analytics Hub API untuk project Google Cloud Anda.

Mengaktifkan Analytics Hub API

gcloud

Jalankan perintah gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola langganan, minta administrator untuk memberi Anda peran IAM Analytics Hub Subscription Owner (roles/analyticshub.subscriptionOwner) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran kustom atau peran yang telah ditentukan lainnya.

Alur kerja subscriber

Pelanggan dapat melakukan tindakan berikut pada langganan.

Berlangganan listingan

Untuk berlangganan listingan, ikuti langkah-langkah di Berlangganan listingan.

Mencantumkan langganan

Untuk melihat langganan Anda saat ini dalam project tertentu, gunakan metode projects.locations.subscriptions.list:

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

Ganti kode berikut:

  • PROJECT_ID: project ID yang berisi langganan yang ingin Anda cantumkan.

  • LOCATION: lokasi yang ingin Anda cantumkan langganan yang ada.

Menghapus langganan

Untuk menghapus langganan, gunakan metode projects.locations.subscriptions.delete:

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

Ganti kode berikut:

  • PROJECT_ID: project ID yang berisi langganan yang ingin Anda hapus.
  • LOCATION: lokasi langganan yang ingin Anda hapus. Untuk mengetahui informasi selengkapnya tentang lokasi yang mendukung berbagi BigQuery, lihat Region yang didukung.
  • SUBSCRIPTION_ID: ID langganan yang ingin Anda hapus.

Isi permintaan harus kosong. Jika permintaan berhasil, isi respons berisi instance operasi.

Jika dimulai oleh pelanggan, penghapusan langganan akan menghapus set data tertaut dari project pelanggan.

Saat menghapus langganan dari listingan untuk beberapa wilayah (Pratinjau), semua replika set data tertaut primer dan sekunder juga akan dihapus dari project pelanggan.

Untuk informasi selengkapnya tentang tugas yang dapat Anda lakukan pada langganan menggunakan API, lihat metode projects.locations.subscriptions.

Alur kerja publisher

Penerbit dapat melakukan tindakan-tindakan berikut dengan langganan. Untuk mengetahui informasi selengkapnya tentang cara mengelola langganan listingan, lihat Mengelola listingan.

Mencantumkan langganan

Untuk mencantumkan semua langganan, pilih salah satu opsi berikut.

Konsol

  1. Di konsol Google Cloud , buka halaman Sharing (Analytics Hub).

    Buka Berbagi (Analytics Hub)

    Akan muncul halaman yang menampilkan daftar semua pertukaran data yang dapat Anda akses.

  2. Klik nama pertukaran data tempat Anda ingin mencantumkan langganan.

  3. Klik tab Langganan untuk melihat semua langganan ke listingan dalam pertukaran data.

API

Untuk mencantumkan langganan Listingan di Pertukaran Data tertentu, gunakan metode projects.locations.dataExchanges.listSubscriptions.

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

Ganti kode berikut:

  • PROJECT_ID: project ID Pertukaran Data yang langganannya ingin Anda lihat dalam daftar dan hapus.
  • LOCATION: lokasi Pertukaran Data yang langganannya ingin Anda cantumkan.
  • DATAEXCHANGE_ID: ID Pertukaran Data yang langganannya ingin Anda cantumkan.

Mencabut langganan

Saat penayang mencabut langganan, pelanggan akan kehilangan kemampuan untuk membuat kueri set data tertaut. Karena ini adalah tindakan yang dimulai penayang pada resource milik pelanggan, set data tertaut tetap tidak tertaut di project pelanggan. Pelanggan dapat memilih untuk menghapus set data yang tidak terhubung dengan menghapusnya.

Jika penayang mencabut langganan dari listingan untuk beberapa region (Pratinjau), pelanggan tidak lagi dapat mengirim kueri ke replika set data tertaut primer atau sekunder.

Untuk mencabut langganan, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Sharing (Analytics Hub).

    Buka Berbagi (Analytics Hub)

    Akan muncul halaman yang menampilkan daftar semua pertukaran data yang dapat Anda akses.

  2. Klik nama pertukaran data tempat Anda ingin membuat listingan.

  3. Klik tab Langganan untuk melihat semua langganan ke pertukaran data.

  4. Centang kotak di samping langganan yang ingin Anda batalkan, atau pilih semua langganan.

  5. Klik Cabut langganan.

API

Untuk mencabut langganan, gunakan metode projects.locations.subscriptions.revoke.

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

Ganti kode berikut:

  • PROJECT_ID: project ID langganan yang ingin Anda batalkan.
  • LOCATION: lokasi langganan.
  • SUBSCRIPTION_ID: ID langganan yang ingin Anda batalkan.

Batasan

Langganan tunduk pada batasan-batasan berikut:

  • Set data tertaut yang dibuat sebelum 25 Juli 2023 tidak akan diisi ulang. Hanya langganan yang dibuat setelah 25 Juli 2023 yang berfungsi dengan metode API.

Langkah berikutnya