Method: projects.locations.dataExchanges.listings.subscribe

Consente di iscriversi a una scheda.

Al momento, con Analytics Hub puoi creare schede che fanno riferimento solo a set di dati BigQuery. Al momento dell'iscrizione a una scheda per un set di dati BigQuery, Analytics Hub crea un set di dati collegato nel progetto dell'abbonato.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome risorsa della scheda a cui vuoi abbonarti, 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 unione destination. Destinazione risultante 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

Messaggio di risposta quando ti abboni a una scheda.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "subscription": {
    object (Subscription)
  }
}
Campi
subscription

object (Subscription)

Oggetto sottoscrizione creato da questa azione di sottoscrizione.

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 per la risorsa name:

  • analyticshub.listings.subscribe

Per saperne di più, 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 del set di dati.
description

string

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

map (key: string, value: string)

Facoltativo. Le etichette associate a questo set di dati. Puoi utilizzarli per organizzare e raggruppare i tuoi set di dati. Puoi impostare questa proprietà quando inserisci o aggiorni un set di dati. Per ulteriori informazioni, consulta 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 dovrebbe trovarsi il set di dati. Per le località supportate, consulta 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.