Abos verwalten

Als Analytics Hub-Abonnent können Sie die folgenden Aufgaben ausführen:

  • Eintrag abonnieren
  • Aktuelle Abos in einem bestimmten Projekt auflisten
  • Ein Abo löschen

Als Analytics Hub-Publisher können Sie die folgenden Aufgaben ausführen:

  • Alle Abos Ihres Eintrags ansehen
  • Zugriff auf ein bestimmtes Abo widerrufen

Ein Abo ist eine regionalisierte Ressource, die sich im Projekt des Abonnenten befindet. Abos speichern relevante Informationen zum Abonnenten und stellen den Vertrag zwischen Publisher und Abonnent dar.

Hinweise

Damit Sie Analytics Hub nutzen können, müssen Sie die Analytics Hub API in Ihrem Google Cloud-Projekt aktivieren.

Erforderliche Berechtigungen

Zum Aktivieren der Analytics Hub API benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

Die folgende vordefinierte IAM-Rolle enthält die Berechtigungen, die Sie zum Aktivieren der Analytics Hub API benötigen:

  • roles/serviceusage.serviceUsageAdmin

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Analytics Hub API aktivieren

So aktivieren Sie die Analytics Hub API:

Console

Rufen Sie die Analytics Hub API für Ihr Google Cloud-Projekt auf und aktivieren Sie sie.

Analytics Hub API aktivieren

gcloud

Führen Sie den Befehl gcloud services enable aus:

gcloud services enable analyticshub.googleapis.com

Erforderliche Berechtigungen

Zum Verwalten von Abos benötigen Sie eine der folgenden Analytics Hub-Rollen:

  • Rolle „Analytics Hub Subscription Owner“ (roles/analyticshub.subscriptionOwner), mit der Sie Abos verwalten können, die Sie erstellen.

Weitere Informationen finden Sie unter Analytics Hub-Nutzerrollen.

Abonnenten-Workflow

Abonnenten können für Abos die folgenden Aktionen ausführen.

Einträge abonnieren

Führen Sie die Schritte unter Einträge abonnieren aus, um Einträge zu abonnieren.

Abos auflisten

Führen Sie zum Auflisten aller Abos die folgenen Schritte aus.

API

Verwenden Sie die Methode projects.locations.subscriptions.list, um Ihre aktuellen Abos in einem bestimmten Projekt aufzurufen.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID, die die Abos enthält, die Sie auflisten möchten.

  • LOCATION: der Standort, für den Sie die vorhandenen Abos auflisten möchten.

Publisher-Workflow

Publisher können für Abos die folgenden Aktionen ausführen. Weitere Informationen zum Verwalten von Abos für Einträge finden Sie unter Einträge verwalten.

Abos auflisten

Führen Sie zum Auflisten aller Abos die folgenen Schritte aus.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Analytics-Hub auf.

    Zum Analytics Hub

    Es wird eine Seite angezeigt, auf der alle Datenaustauschplattformen aufgeführt sind, auf die Sie zugreifen können.

  2. Klicken Sie auf den Namen der Datenaustauschplattform, in der Sie die Abos auflisten möchten.

  3. Klicken Sie auf den Tab Abos, um alle Abos für Einträge in der Datenaustauschplattform aufzurufen.

API

Verwenden Sie die Methode projects.locations.dataExchanges.listSubscriptions, um Abos von Einträgen in einem bestimmten Data Exchange aufzulisten.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Data Exchange, für den Sie die Abos auflisten möchten, die Sie entfernen möchten.
  • LOCATION ist der Standort von Data Exchange.
  • DATAEXCHANGE_ID: Die ID des Data Exchange, für den Sie die Abos auflisten möchten.

Abos entfernen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Analytics-Hub auf.

    Zum Analytics Hub

    Es wird eine Seite angezeigt, auf der alle Datenaustauschplattformen aufgeführt sind, auf die Sie zugreifen können.

  2. Klicken Sie auf den Namen des Datenaustauschs, in dem Sie den Eintrag erstellen möchten.

  3. Klicken Sie auf den Tab Abos, um alle Abos für die Datenaustauschplattform aufzurufen.

  4. Klicken Sie auf das Kästchen neben den Abos, die Sie entfernen möchten, oder wählen Sie alle Abos aus.

  5. Klicken Sie auf Abos entfernen.

API

Wenn Sie ein Abo entfernen möchten, verwenden Sie die Methode projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Abos, das Sie entfernen möchten.
  • LOCATION: der Standort des Abos.
  • SUBSCRIPTION_ID: die ID des Abos, das Sie entfernen möchten.

Beschränkungen

Abos unterliegen den folgenden Beschränkungen:

  • Verknüpfte Datasets, die vor dem 25. Juli 2023 erstellt wurden, werden nicht per Backfill ausgefüllt. Nur Abos, die nach dem 25. Juli 2023 erstellt wurden, funktionieren mit den API-Methoden.

Nächste Schritte