Method: projects.locations.dataExchanges.listings.subscribe

Abonniert einen Eintrag.

Derzeit können Sie mit Analytics Hub Einträge erstellen, die nur auf BigQuery-Datasets verweisen. Beim Abo eines Eintrags für ein BigQuery-Dataset erstellt Analytics Hub ein verknüpftes Dataset im Projekt des Abonnenten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname des Eintrags, den Sie abonnieren möchten. z.B. projects/myproject/locations/US/dataExchanges/123/listings/456.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{

  // Union field destination can be only one of the following:
  "destinationDataset": {
    object (DestinationDataset)
  }
  // End of list of possible types for union field destination.
}
Felder
Union-Feld destination. Daraus resultierendes Ziel des Eintrags, den Sie abonniert haben. Für destination ist nur einer der folgenden Werte zulässig:
destinationDataset

object (DestinationDataset)

BigQuery-Ziel-Dataset, das für den Abonnenten erstellt werden soll.

Antworttext

Nachricht für die Antwort beim Abonnieren eines Eintrags.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "subscription": {
    object (Subscription)
  }
}
Felder
subscription

object (Subscription)

Abo-Objekt, das aus dieser Abonnieraktion erstellt wird.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • analyticshub.listings.subscribe

Weitere Informationen finden Sie in der IAM-Dokumentation.

DestinationDataset

Definiert das BigQuery-Ziel-Dataset.

JSON-Darstellung 
{
  "datasetReference": {
    object (DestinationDatasetReference)
  },
  "friendlyName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "location": string
}
Felder
datasetReference

object (DestinationDatasetReference)

Erforderlich. Eine Referenz, die das Ziel-Dataset identifiziert.
friendlyName

string

Optional. Ein aussagekräftiger Name für das Dataset.
description

string

Optional. Eine nutzerfreundliche Beschreibung des Datasets.
labels

map (key: string, value: string)

Optional. Die mit diesem Dataset verknüpften Labels. Damit können Sie Ihre Datasets organisieren und gruppieren. Sie können diese Eigenschaft festlegen, wenn Sie ein Dataset einfügen oder aktualisieren. Weitere Informationen finden Sie unter https://cloud.google.com/resource-manager/docs/creating-managing-labels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
location

string

Erforderlich. Der geografische Standort, an dem sich das Dataset befinden soll. Unterstützte Standorte finden Sie unter https://cloud.google.com/bigquery/docs/locations.

DestinationDatasetReference

Enthält die Referenz, die ein BigQuery-Ziel-Dataset identifiziert.

JSON-Darstellung 
{
  "datasetId": string,
  "projectId": string
}
Felder
datasetId

string

Erforderlich. Eine eindeutige ID für dieses Dataset ohne den Projektnamen. Die ID darf nur Buchstaben (a–z, A–Z), Ziffern (0–9) und Unterstriche (_) enthalten. Die maximale Länge beträgt 1.024 Zeichen.
projectId

string

Erforderlich. Die ID des Projekts, das dieses Dataset enthält.