Method: projects.locations.dataExchanges.listings.subscribe

Si iscrive a una scheda.

Al momento, con Analytics Hub puoi creare schede che fanno riferimento solo a set di dati BigQuery. Dopo aver sottoscritto l'abbonamento a un elenco di un set di dati BigQuery, Analytics Hub crea un set di dati collegato nel progetto del sottoscrittore.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome della risorsa della scheda a cui vuoi iscriverti, ad esempio projects/myproject/locations/US/dataExchanges/123/listings/456.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{

  // Union field destination can be only one of the following:
  "destinationDataset": {
    object (DestinationDataset)
  }
  // End of list of possible types for union field destination.
}
Campi
Campo di unione destination. Destinazione finale della scheda a cui hai effettuato l'iscrizione. destination può essere solo uno dei seguenti:
destinationDataset

object (DestinationDataset)

Set di dati di destinazione BigQuery da creare per il sottoscrittore.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM sulla risorsa name:

  • analyticshub.listings.subscribe

Per ulteriori informazioni, consulta la documentazione IAM.

DestinationDataset

Definisce il set di dati BigQuery di destinazione.

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

object (DestinationDatasetReference)

Obbligatorio. Un riferimento che identifica il set di dati di destinazione.
friendlyName

string

Facoltativo. Un nome descrittivo per il set di dati.
description

string

Facoltativo. Una descrizione del set di dati facile da usare.
labels

map (key: string, value: string)

Facoltativo. Le etichette associate al set di dati. che puoi utilizzare per organizzare e raggruppare i tuoi set di dati. Puoi impostare questa proprietà durante l'inserimento o l'aggiornamento di un set di dati. Per ulteriori informazioni, vedi https://cloud.google.com/resource-manager/docs/creating-managing-labels.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
location

string

Obbligatorio. La posizione geografica in cui deve risiedere il set di dati. Per conoscere le località supportate, consulta la pagina https://cloud.google.com/bigquery/docs/locations.

DestinationDatasetReference

Contiene il riferimento che identifica un set di dati BigQuery di destinazione.

Rappresentazione JSON 
{
  "datasetId": string,
  "projectId": string
}
Campi
datasetId

string

Obbligatorio. Un ID univoco per questo set di dati, senza il nome del progetto. L'ID deve contenere solo lettere (a-z, A-Z), numeri (0-9) o trattini bassi (_). La lunghezza massima è di 1024 caratteri.
projectId

string

Obbligatorio. L'ID del progetto contenente questo set di dati.