REST Resource: projects.locations.dataExchanges.listings

Referensi: Listingan

Listingan adalah apa yang dipublikasikan ke pertukaran data yang dapat diikuti pelanggan. {i>Dataset<i} ini berisi referensi ke sumber data bersama dengan informasi deskriptif yang akan membantu pelanggan menemukan dan berlangganan data tersebut.

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "primaryContact": string,
  "documentation": string,
  "state": enum (State),
  "icon": string,
  "dataProvider": {
    object (DataProvider)
  },
  "categories": [
    enum (Category)
  ],
  "publisher": {
    object (Publisher)
  },
  "requestAccess": string,
  "restrictedExportConfig": {
    object (RestrictedExportConfig)
  },

  // Union field source can be only one of the following:
  "bigqueryDataset": {
    object (BigQueryDatasetSource)
  }
  // End of list of possible types for union field source.
}
Kolom
name

string

Hanya output. Nama resource listingan, misalnya, projects/myproject/locations/US/dataExchanges/123/listings/456
displayName

string

Wajib. Nama tampilan listingan yang dapat dibaca manusia. Nama tampilan hanya boleh berisi huruf Unicode, angka (0-9), garis bawah (_), tanda hubung (-), spasi ( ), tanda dan (&), dan tidak boleh diawali atau diakhiri dengan spasi. Nilai defaultnya adalah string kosong. Panjang maksimal: 63 byte.
description

string

Opsional. Deskripsi singkat listingan. Deskripsi tidak boleh berisi non-karakter Unicode serta kode kontrol C0 dan C1 kecuali tab (HT), baris baru (LF), enter (CR), dan batas halaman (FF). Nilai defaultnya adalah string kosong. Panjang maksimal: 2.000 byte.
primaryContact

string

Opsional. Email atau URL kontak utama listingan. Panjang Maks: 1.000 byte.
documentation

string

Opsional. Dokumentasi yang menjelaskan listingan.
state

enum (State)

Hanya output. Status listingan saat ini.
icon

string (bytes format)

Opsional. Gambar berenkode Base64 yang mewakili listingan. Ukuran Maksimum: 3.0MiB Dimensi gambar yang diharapkan adalah 512 x 512 piksel, namun API hanya melakukan validasi ukuran data yang dienkode. Catatan: Untuk kolom byte, konten kolom berenkode base64 (yang meningkatkan ukuran data sebesar 33-36%) saat menggunakan JSON pada kabel.

String berenkode base64.
dataProvider

object (DataProvider)

Opsional. Detail penyedia data yang memiliki data sumber.
categories[]

enum (Category)

Opsional. Kategori listingan. Maksimal dua kategori diizinkan.
publisher

object (Publisher)

Opsional. Detail penayang yang memiliki listingan dan siapa yang dapat membagikan data sumber.
requestAccess

string

Opsional. Email atau URL permintaan akses listingan. Pelanggan dapat menggunakan referensi ini untuk meminta akses. Panjang Maks: 1.000 byte.
restrictedExportConfig

object (RestrictedExportConfig)

Opsional. Jika ditetapkan, konfigurasi ekspor yang dibatasi akan diterapkan dan diterapkan pada set data yang ditautkan.
Kolom union source. Sumber listingan. source hanya ada berupa salah satu diantara berikut:
bigqueryDataset

object (BigQueryDatasetSource)

Wajib. Set data bersama, yaitu sumber set data BigQuery.

BigQueryDatasetSource

Referensi ke set data bersama. BigQuery adalah {i>dataset<i} BigQuery yang berisi kumpulan objek seperti tabel dan tampilan yang ingin Anda bagikan kepada pelanggan. Saat pelanggan berlangganan listingan, Analytics Hub akan membuat set data tertaut di project pelanggan. Set data tertaut adalah set data BigQuery buram dan hanya baca yang berfungsi sebagai link simbolis ke set data bersama.

Representasi JSON 
{
  "dataset": string
}
Kolom
dataset

string

Nama resource sumber set data untuk listingan ini. misalnya projects/myproject/datasets/123

Negara bagian/Provinsi

Status listingan.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
ACTIVE Status langganan. Pengguna dengan izin data exchange.listings.subscribe dapat berlangganan listingan ini.

DataProvider

Berisi detail penyedia data.

Representasi JSON 
{
  "name": string,
  "primaryContact": string
}
Kolom
name

string

Opsional. Nama penyedia data.
primaryContact

string

Opsional. Email atau URL penyedia data. Panjang Maks: 1.000 byte.

Kategori

Kategori listingan.

Enum
CATEGORY_UNSPECIFIED
CATEGORY_OTHERS
CATEGORY_ADVERTISING_AND_MARKETING
CATEGORY_COMMERCE
CATEGORY_CLIMATE_AND_ENVIRONMENT
CATEGORY_DEMOGRAPHICS
CATEGORY_ECONOMICS
CATEGORY_EDUCATION
CATEGORY_ENERGY
CATEGORY_FINANCIAL
CATEGORY_GAMING
CATEGORY_GEOSPATIAL
CATEGORY_HEALTHCARE_AND_LIFE_SCIENCE
CATEGORY_MEDIA
CATEGORY_PUBLIC_SECTOR
CATEGORY_RETAIL
CATEGORY_SPORTS
CATEGORY_SCIENCE_AND_RESEARCH
CATEGORY_TRANSPORTATION_AND_LOGISTICS
CATEGORY_TRAVEL_AND_TOURISM

Publisher

Berisi detail penayang listingan.

Representasi JSON 
{
  "name": string,
  "primaryContact": string
}
Kolom
name

string

Opsional. Nama penayang listingan.
primaryContact

string

Opsional. Email atau URL penerbit listingan. Panjang Maks: 1.000 byte.

RestrictedExportConfig

Konfigurasi ekspor terbatas, digunakan untuk mengonfigurasi ekspor yang dibatasi pada set data tertaut.

Representasi JSON 
{
  "enabled": boolean,
  "restrictDirectTableAccess": boolean,
  "restrictQueryResult": boolean
}
Kolom
enabled

boolean

Opsional. Jika true (benar), aktifkan ekspor yang dibatasi.
restrictDirectTableAccess

boolean

Hanya output. Jika true (benar), batasi akses tabel langsung (baca api/tabledata.list) di tabel tertaut.
restrictQueryResult

boolean

Opsional. Jika true (benar), batasi ekspor hasil kueri yang berasal dari tabel set data tertaut yang dibatasi.

Metode

create

 Membuat listingan baru.

delete

 Menghapus listingan.

get

 Mendapatkan detail listingan.

getIamPolicy

 Mendapatkan kebijakan IAM.

list

 Mencantumkan semua listingan dalam project dan lokasi tertentu.

listSubscriptions

 Mencantumkan semua langganan di Data Exchange atau Listingan tertentu.

patch

 Memperbarui listingan yang ada.

setIamPolicy

 Menetapkan kebijakan IAM.

subscribe

 Berlangganan listingan.

testIamPermissions

 Menampilkan izin yang dimiliki pemanggil.