REST Resource: projects.locations.dataExchanges.listings

Risorsa: elenco

Una scheda è ciò che viene pubblicato in uno scambio di dati a cui un abbonato può abbonarsi. 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 risorsa della scheda, ad esempio projects/myproject/locations/US/dataExchanges/123/listings/456

displayName

string

Obbligatorio. Nome visualizzato della scheda leggibile. Il nome visualizzato deve contenere solo lettere Unicode, numeri (0-9), trattini bassi (_), trattini (-), spazi ( ), e commerciali (&) 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 i 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 codificata Base64 che rappresenta l'elenco. Dimensione massima: 3,0 MiB Le dimensioni dell'immagine previste 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 sul cavo.

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 sul publisher proprietario della scheda e chi può condividere i dati di origine.

requestAccess

string

Facoltativo. 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 unione source. Origine scheda. source può essere solo uno dei seguenti:
bigqueryDataset

object (BigQueryDatasetSource)

Obbligatorio. Set di dati condiviso, ad es. origine del set di dati BigQuery.

BigQueryDatasetSource

Un riferimento a un set di dati condiviso. È un set di dati BigQuery esistente con una raccolta di oggetti che vuoi condividere con i sottoscrittori, ad esempio tabelle e viste. Quando un abbonato 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 e di sola lettura che funge da link simbolico a un set di dati condiviso.

Rappresentazione JSON
{
  "dataset": string
}
Campi
dataset

string

Nome 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 dell'abbonamento. Gli utenti con l'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

Categorie delle schede.

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. Email o URL del publisher della scheda. Lunghezza massima: 1000 byte.

RestrictedExportConfig

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

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

boolean

Facoltativo. Se impostato su 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 impostato su 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 in un progetto e in una località specifici.

listSubscriptions

Elenca tutte le sottoscrizioni in un determinato scambio o scheda di dati.

patch

Consente di aggiornare una scheda esistente.

setIamPolicy

Imposta il criterio IAM.

subscribe

Consente di iscriversi a una scheda.

testIamPermissions

Restituisce le autorizzazioni di cui dispone il chiamante.