REST Resource: projects.locations.dataExchanges.listings

Risorsa: elenco

Una scheda è ciò che viene pubblicato in uno scambio di dati a cui un abbonato può iscriversi. Contiene un riferimento all'origine dati e informazioni descrittive che aiuteranno gli abbonati a trovare e sottoscrivere i dati.

Rappresentazione 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.
}
Campi
name

string

Solo output. Il nome della risorsa della scheda, ad esempio projects/myproject/locations/US/dataExchanges/123/listings/456
displayName

string

Obbligatorio. Nome visualizzato leggibile della scheda. Il nome visualizzato deve contenere solo lettere Unicode, numeri (0-9), trattini bassi (_), trattini (-), spazi ( ), e commerciale (&) e non può iniziare o terminare con spazi. Il valore predefinito è una stringa vuota. Lunghezza massima: 63 byte.
description

string

Facoltativo. Breve descrizione della scheda. La descrizione non deve contenere caratteri Unicode senza caratteri e codici di controllo C0 e C1, ad eccezione di tabulazioni (HT), nuove righe (LF), ritorni a capo (CR) e interruzioni di pagina (FF). Il valore predefinito è una stringa vuota. Lunghezza massima: 2000 byte.
primaryContact

string

Facoltativo. Indirizzo email o URL del punto di contatto principale della scheda. Lunghezza massima: 1000 byte.
documentation

string

Facoltativo. Documentazione che descrive la scheda.
state

enum (State)

Solo output. Stato attuale della scheda.
icon

string (bytes format)

Facoltativo. Immagine con codifica Base64 che rappresenta l'elenco. Dimensione massima: 3,0 MiB Le dimensioni previste per l'immagine sono 512 x 512 pixel, tuttavia l'API esegue la convalida solo sulla dimensione dei dati codificati. Nota: per i campi di byte, i contenuti del campo sono codificati in base64 (che aumenta la dimensione dei dati del 33-36%) quando si utilizza JSON on-line.

Una stringa con codifica Base64.
dataProvider

object (DataProvider)

Facoltativo. Dettagli del fornitore di dati proprietario dei dati di origine.
categories[]

enum (Category)

Facoltativo. Categorie della scheda. Sono consentite fino a due categorie.
publisher

object (Publisher)

Facoltativo. Dettagli del publisher proprietario della scheda e chi può condividere i dati di origine.
requestAccess

string

Facoltativo. Indirizzo email o URL della richiesta di accesso alla scheda. I sottoscrittori possono utilizzare questo riferimento per richiedere l'accesso. Lunghezza massima: 1000 byte.
restrictedExportConfig

object (RestrictedExportConfig)

Facoltativo. Se impostata, la configurazione dell'esportazione limitata verrà propagata e applicata al set di dati collegato.
Campo di unione source. Origine scheda. source può essere solo uno dei seguenti:
bigqueryDataset

object (BigQueryDatasetSource)

Obbligatorio. Set di dati condiviso, ovvero origine del set di dati BigQuery.

BigQueryDatasetSource

Un riferimento a un set di dati condiviso. Si tratta di un set di dati BigQuery esistente con una raccolta di oggetti come tabelle e viste che vuoi condividere con gli abbonati. Quando un sottoscrittore si abbona a una scheda, Analytics Hub crea un set di dati collegato nel progetto dell'abbonato. Un set di dati collegato è un set di dati BigQuery opaco di sola lettura che funge da link simbolico a un set di dati condiviso.

Rappresentazione JSON 
{
  "dataset": string
}
Campi
dataset

string

Nome della risorsa dell'origine del set di dati per questa scheda, ad esempio projects/myproject/datasets/123

Stato

Stato della scheda.

Enum
STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
ACTIVE Stato iscrizione. Gli utenti con autorizzazione dataexchange.listings.subscribe possono iscriversi a questa scheda.

DataProvider

Contiene i dettagli del fornitore di dati.

Rappresentazione JSON 
{
  "name": string,
  "primaryContact": string
}
Campi
name

string

Facoltativo. Nome del fornitore di dati.
primaryContact

string

Facoltativo. Indirizzo email o URL del fornitore di dati. Lunghezza massima: 1000 byte.

Categoria

Elenco delle categorie.

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

Contiene i dettagli del publisher della scheda.

Rappresentazione JSON 
{
  "name": string,
  "primaryContact": string
}
Campi
name

string

Facoltativo. Nome del publisher della scheda.
primaryContact

string

Facoltativo. Indirizzo email o URL del publisher della scheda. Lunghezza massima: 1000 byte.

RestrictedExportConfig

Configurazione dell'esportazione limitata, utilizzata per configurare l'esportazione limitata nel set di dati collegato.

Rappresentazione JSON 
{
  "enabled": boolean,
  "restrictDirectTableAccess": boolean,
  "restrictQueryResult": boolean
}
Campi
enabled

boolean

Facoltativo. Se il valore è true, abilita l'esportazione limitata.
restrictDirectTableAccess

boolean

Solo output. Se il valore è true, limita l'accesso diretto alla tabella(leggi api/tabledata.list) nella tabella collegata.
restrictQueryResult

boolean

Facoltativo. Se il valore è true, limita l'esportazione del risultato della query derivato dalla tabella del set di dati collegato limitato.

Metodi

create

 Crea una nuova scheda.

delete

 Elimina una scheda.

get

 Recupera i dettagli di una scheda.

getIamPolicy

 Recupera il criterio IAM.

list

 Elenca tutte le schede di un determinato progetto e località.

listSubscriptions

 Elenca tutte le sottoscrizioni in un determinato Data Exchange o scheda.

patch

 Aggiorna una scheda esistente.

setIamPolicy

 Imposta il criterio IAM.

subscribe

 Si iscrive a una scheda.

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante.