Method: projects.locations.dataExchanges.listings.subscribe

Berlangganan listingan.

Saat ini, dengan Analytics Hub, Anda dapat membuat listingan yang hanya mereferensikan set data BigQuery. Setelah berlangganan listingan untuk set data BigQuery, Analytics Hub akan membuat set data tertaut di project pelanggan.

Permintaan HTTP

POST https://analyticshub.googleapis.com/v1/{name=projects/*/locations/*/dataExchanges/*/listings/*}:subscribe

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource listingan yang ingin Anda langgani, misalnya projects/myproject/locations/US/dataExchanges/123/listings/456.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{

  // Union field destination can be only one of the following:
  "destinationDataset": {
    object (DestinationDataset)
  }
  // End of list of possible types for union field destination.
}
Kolom
Kolom union destination. Hasil tujuan listingan yang Anda ikuti. destination hanya ada berupa salah satu diantara berikut:
destinationDataset

object (DestinationDataset)

Set data tujuan BigQuery yang akan dibuat untuk pelanggan.

Isi respons

Pesan respons saat Anda berlangganan listingan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "subscription": {
    object (Subscription)
  }
}
Kolom
subscription

object (Subscription)

Objek langganan yang dibuat dari tindakan berlangganan ini.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • analyticshub.listings.subscribe

Untuk informasi lebih lanjut, lihat dokumentasi IAM.

DestinationDataset

Menentukan set data bigquery tujuan.

Representasi JSON
{
  "datasetReference": {
    object (DestinationDatasetReference)
  },
  "friendlyName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "location": string
}
Kolom
datasetReference

object (DestinationDatasetReference)

Wajib. Referensi yang mengidentifikasi set data tujuan.

friendlyName

string

Opsional. Nama deskriptif untuk set data.

description

string

Opsional. Deskripsi {i>dataset<i} yang mudah digunakan.

labels

map (key: string, value: string)

Opsional. Label yang terkait dengan set data ini. Anda dapat menggunakannya untuk mengatur dan mengelompokkan {i>dataset<i} Anda. Anda dapat menetapkan properti ini saat menyisipkan atau memperbarui set data. Lihat https://cloud.google.com/resource-manager/docs/creating-managing-labels untuk mengetahui informasi selengkapnya.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

location

string

Wajib. Lokasi geografis tempat set data seharusnya berada. Lihat https://cloud.google.com/bigquery/docs/locations untuk lokasi yang didukung.

DestinationDatasetReference

Berisi referensi yang mengidentifikasi set data bigquery tujuan.

Representasi JSON
{
  "datasetId": string,
  "projectId": string
}
Kolom
datasetId

string

Wajib. ID unik untuk set data ini, tanpa nama project. ID hanya boleh berisi huruf (a-z, A-Z), angka (0-9), atau garis bawah (_). Panjang maksimum adalah 1.024 karakter.

projectId

string

Wajib. ID project yang berisi set data ini.