Einträge verwalten

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

• Einträge in einer Datenaustauschplattform erstellen, auf die Sie Veröffentlichungszugriff haben.
• Nutzungsmesswerte für Einträge aktualisieren, löschen, freigeben und ansehen.
• Verschiedene Rollen für Ihre Analytics Hub-Einträge verwalten, z. B. für Eintragsadministratoren, Abonnenten und Betrachter.
• Alle Abonnenten aufrufen, die Ihren Eintrag abonniert haben.
• Die Nutzung Ihrer Einträge überwachen.
• Abonnenten aus dem Eintrag entfernen.

Ein Eintrag ist ein Verweis auf ein freigegebenes Dataset, das ein Publisher in einem Datenaustausch auflistet. Ein Eintrag kann zu einem der folgenden beiden Typen gehören, basierend auf der IAM-Richtlinie (Identity and Access Management), die für den Eintrag festgelegt ist, und dem Typ des Datenaustauschs, der den Eintrag enthält:

• Öffentlicher Eintrag. Er kann von Google Cloud-Nutzern (allAuthenticatedUsers) gefunden und abonniert werden. Einträge in einer öffentlichen Datenaustauschplattform sind öffentliche Einträge. Diese Einträge können Verweise auf ein kostenloses öffentliches Dataset oder ein kommerzielles Dataset sein. Wenn der Eintrag ein kommerzielles Dataset betrifft, können Abonnenten Zugriff auf den Eintrag anfordern und der Datenanbieter kontaktiert diese Abonnenten dann direkt.

• Privater Eintrag. Dieser wird direkt für Einzelpersonen oder Gruppen freigegeben. Beispielsweise kann ein privater Eintrag auf Marketingmesswerte-Datasets verweisen, die Sie für andere interne Teams in Ihrer Organisation freigeben. Obwohl Sie allAuthenticatedUsers erlauben, Ihre Einträge zu abonnieren, bleibt der Eintrag privat und wird nicht als öffentlicher Eintrag auf der Analytics-Hub-Seite angezeigt. Wenn Sie solche Einträge mit Nutzern teilen möchten, geben Sie ihnen die URL des Eintrags. Damit ein privater Eintrag gefunden werden kann, müssen Sie Ihren Datenaustausch veröffentlichen.

Vorbereitung

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 Einträgen und Abos benötigen Sie eine der folgenden Analytics Hub-Rollen:

• Rolle „Analytics Hub-Publisher“ (roles/analyticshub.publisher), mit der Sie IAM-Richtlinien für Ihre Einträge erstellen, aktualisieren, löschen und festlegen können.

• Rolle „Administrator für Analytics Hub-Einträge“ (roles/analyticshub.listingAdmin), mit der Sie IAM-Richtlinien für Ihre Einträge aktualisieren, löschen und festlegen können.

• Rolle „Analytics Hub-Administrator“ (roles/analyticshub.Admin), mit der Sie IAM-Richtlinien für alle Einträge in Ihrem Datenaustausch erstellen, aktualisieren, löschen und festlegen können.

Weitere Informationen finden Sie unter Nutzerrollen für Analytics Hub. Informationen zum Zuweisen dieser Rollen für andere Nutzer finden Sie unter Eintragsadministrator erstellen.

Zum Erstellen von Einträgen benötigen Sie außerdem die Berechtigungen bigquery.datasets.getund bigquery.datasets.update für die Datasets, für die Sie Einträge erstellen möchten. Folgende vordefinierte BigQuery-Rollen haben die Berechtigung bigquery.datasets.update:

• Rolle „BigQuery-Dateninhaber“ (roles/bigquery.dataOwner)
• BigQuery-Administratorrolle (roles/bigquery.admin)

Wenn Sie alle Datenaustausch zwischen Projekten in einer Organisation ansehen möchten, auf die Sie Zugriff haben, benötigen Sie die Berechtigung resourcemanager.organizations.get. Es gibt keine vordefinierten BigQuery-Rollen, die diese Berechtigung enthalten. Sie müssen daher eine benutzerdefinierte IAM-Rolle verwenden.

Datenaustausch ansehen

Informationen zum Aufrufen der Datenaustauschliste in Ihrer Organisation, auf die Sie Zugriff haben, finden Sie unter Datenaustausch aufrufen. Wenn sich der Datenaustausch in einer anderen Organisation befindet, muss der Analytics Hub-Administrator einen Link zu diesem Datenaustausch für Sie freigeben.

Eintrag erstellen

Ein Eintrag ist ein Verweis auf ein freigegebenes Dataset, das ein Publisher in einem Datenaustausch auflistet.

Achtung: Wir empfehlen, dass Sie Ihre freigegebenen Datasets nicht in einem Projekt mit einem VPC Service Controls-Perimeter hinzufügen. In diesem Fall müssen Sie die entsprechenden Regeln für eingehenden und ausgehenden Traffic hinzufügen.

So erstellen Sie einen Eintrag:

Console

1. Rufen Sie 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 Eintrag erstellen.

4. Geben Sie auf der Seite Eintrag erstellen unter Anzeigename den Namen des Eintrags ein.

5. Wenn Sie einen kommerziellen Eintrag erstellen, müssen Sie das Feld Zugriffskontakt anfordern ausfüllen. Sie müssen eine E-Mail-Adresse oder eine URL des Aufnahmeformulars eingeben, damit die Abonnenten Sie kontaktieren können.

6. Optional: Geben Sie die folgenden Informationen ein:

   • Primärer Kontakt: Geben Sie eine E-Mail-Adresse oder eine URL des primären Kontakts für den Eintrag ein.

   • Kategorie: Wählen Sie bis zu zwei Kategorien aus, die Ihren Eintrag am besten darstellen. Abonnenten können nach diesen Kategorien Einträge filtern.

   • Anbieter: Maximieren Sie den Abschnitt Anbieter und geben Sie in den folgenden Feldern Details an:

     • Providername: der Name des Dataset-Anbieters.
     • Primärer Kontakt des Anbieters: Eine E-Mail-Adresse oder eine URL des primären Kontakts des Dataset-Anbieters.

     Abonnenten können Einträge basierend auf den Datenanbietern filtern.

   • Publisher: Maximieren Sie den Abschnitt Publisher und geben Sie Details in den folgenden Feldern an:

     • Publisher-Name: der Name des Publishers, der den Eintrag erstellt.
     • Primärer Kontakt des Publishers: Eine E-Mail-Adresse oder eine URL des primären Kontakts des Datasets-Publishers.

   • Symbol: Ein Symbol für Ihren Eintrag. Unterstützt werden die Dateiformate PNG und JPEG. Die Dateigröße der Symbole muss unter 512 KiB liegen und die Abmessungen dürfen 512 x 512 Pixel nicht überschreiten.

   • Beschreibung: Eine kurze Beschreibung Ihres Eintrags. Abonnenten können anhand der Beschreibung nach Einträgen suchen.

7. Wählen Sie unter Quell-Dataset das Dataset aus, das Sie im Datenaustausch auflisten möchten. Das Quell-Dataset muss sich in derselben Region wie der Datenaustausch befinden. Sie können dieses Feld nicht mehr aktualisieren, nachdem der Eintrag erstellt wurde.

   Wichtig: Der Name des Quell-Datasets und die ID des Projekts, das das Dataset enthält, werden zurückgegeben, wenn Abonnenten die Metadaten des verknüpften Datasets aufrufen.

8. Wählen Sie in Ausgehender Traffic die entsprechende Ausgehender Traffic-Option. Nur Abonnenten mit Nicht versionsgebundenen Angeboten oder Enterprise Plus Edition können Daten mit Einschränkungen für ausgehenden Traffic abfragen.

   • Um die Beschränkung des ausgehenden Traffics auf Ihr freigegebenes Dataset anzuwenden, aber nicht auf die Abfrageergebnisse Ihres freigegebenes Datasets, wählen Sie Kopieren und Exportieren von freigegebenen Daten deaktivieren.
   • Um die Einschränkungen für ausgehenden Traffic auf Ihr freigegebenes Dataset und die Abfrageergebnisse Ihres freigegebenen Datasets anzuwenden, wählen Sie Kopieren und Exportieren von Abfrageergebnissen deaktivieren, wodurch automatisch auch Kopieren und Exportieren von freigegebenen Daten deaktivieren festgelegt wird.
   • Wählen Sie zum Anwenden der Daten-API-Kopier- und Exportbeschränkungen für ausgehenden Traffic auf Ihr freigegebenes Dataset Folgendes aus: Kopieren und Exportieren von Tabellen über APIs deaktivieren, wodurch automatisch auch das Kopieren und Exportieren freigegebener Daten deaktiviert wird.

9. Optional: Klicken Sie im Abschnitt Eintragsdetails auf die Ein/Aus-Schaltfläche Öffentliche Sichtbarkeit, um die öffentliche Sichtbarkeit zu aktivieren. Sie müssen allUsers oder allAuthenticatedUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zuweisen. Weitere Informationen finden Sie unter Rolle für einen Eintrag zuweisen. Wenn die Anzeigenplattform bereits öffentlich ist, wurden die Berechtigungen für den Eintrag bereits übernommen und es sind keine weiteren Maßnahmen erforderlich.

   Öffentlich sichtbare Anzeigenplattformen können aufgrund der Übernahme von Berechtigungen keine privaten Einträge haben, private Anzeigenplattformen können jedoch öffentliche Einträge haben. Damit öffentliche Einträge erstellt werden können, muss das Projekt, in dem sich die Datenliste befindet, eine zugehörige Organisation und ein zugehöriges Rechnungskonto haben.

10. Optional: Im Abschnitt Dokumentation > Markdown können Sie zusätzliche Informationen eingeben, wie Beispielabfragen, die Sie für das Dataset ausführen können, oder Links zu relevanten Dokumentationen und zusätzliche Informationen, die Abonnenten bei der Verwendung Ihres Datasets unterstützen können.

11. Klicken Sie auf Speichern.

API

Verwenden Sie die Methode projects.locations.dataExchanges.listings.create.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

Ersetzen Sie dabei Folgendes:

• PROJECT_ID: die Projekt-ID, die den Datenaustausch enthält, in dem Sie den Eintrag erstellen möchten.
• LOCATION: Der Standort für Ihren Datenaustausch. Weitere Informationen zu Standorten, die Analytics Hub unterstützen, finden Sie unter Unterstützte Regionen.
• DATAEXCHANGE_ID: die Datenpool-ID.
• LISTING_ID: die ID des Eintrags.

Geben Sie im Anfragetext die Eintragsdetails an. Wenn die Anfrage erfolgreich ist, enthält der Antworttext Details zum Eintrag.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Eintrag aus einem Datenpool erstellen

Sie können auch einen Eintrag aus einem Datensatz erstellen. Gehen Sie dazu so vor:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Klicken Sie auf einen Datensatz, um die zugehörigen Details aufzurufen.

3. Klicken Sie auf Teilen > Als Eintrag veröffentlichen.

   Das Dialogfeld Eintrag erstellen wird geöffnet.

4. Wählen Sie einen Datenpool aus, in dem der Eintrag veröffentlicht werden soll. Der Datenaustausch muss sich in derselben Region wie das Dataset befinden. Weitere Informationen zum Erstellen eines Datenaustauschs finden Sie unter Datenaustausch erstellen und Berechtigungen festlegen.

5. Wählen Sie in Ausgehender Traffic die entsprechende Ausgehender Traffic-Option. Nur Abonnenten mit Nicht versionsgebundenen Angeboten oder Enterprise Plus Edition können Daten mit Einschränkungen für ausgehenden Traffic abfragen.

   • Um die Beschränkung des ausgehenden Traffics auf Ihr freigegebenes Dataset anzuwenden, aber nicht auf die Abfrageergebnisse Ihres freigegebenes Datasets, wählen Sie Kopieren und Exportieren von freigegebenen Daten deaktivieren.
   • Um die Einschränkungen für ausgehenden Traffic auf Ihr freigegebenes Dataset und die Abfrageergebnisse Ihres freigegebenen Datasets anzuwenden, wählen Sie Kopieren und Exportieren von Abfrageergebnissen deaktivieren, wodurch automatisch auch Kopieren und Exportieren von freigegebenen Daten deaktivieren festgelegt wird.
   • Wählen Sie zum Anwenden der Daten-API-Kopier- und Exportbeschränkungen für ausgehenden Traffic auf Ihr freigegebenes Dataset Folgendes aus: Kopieren und Exportieren von Tabellen über APIs deaktivieren, wodurch automatisch auch das Kopieren und Exportieren freigegebener Daten deaktiviert wird.

6. Geben Sie die Details zum Eintrag ein.

   Anzeigename ist der Name dieses Eintrags und ist erforderlich. andere Felder sind optional.

7. Optional: Klicken Sie auf die Ein/Aus-Schaltfläche Öffentliche Sichtbarkeit, um die öffentliche Sichtbarkeit zu aktivieren. Sie müssen allUsers oder allAuthenticatedUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zuweisen. Weitere Informationen finden Sie unter Rolle für einen Eintrag zuweisen. Wenn die Anzeigenplattform bereits öffentlich ist, wurden die Berechtigungen für den Eintrag bereits übernommen und es sind keine weiteren Maßnahmen erforderlich.

   Öffentlich sichtbare Anzeigenplattformen können aufgrund der Übernahme von Berechtigungen keine privaten Einträge haben, private Anzeigenplattformen können jedoch öffentliche Einträge haben. Damit öffentliche Einträge erstellt werden können, muss das Projekt, in dem sich die Datenliste befindet, eine zugehörige Organisation und ein zugehöriges Rechnungskonto haben.

8. Optional: Im Abschnitt Dokumentation > Markdown können Sie zusätzliche Informationen eingeben, wie Beispielabfragen, die Sie für das Dataset ausführen können, oder Links zu relevanten Dokumentationen und zusätzliche Informationen, die Abonnenten bei der Verwendung Ihres Datasets unterstützen können.

9. Klicken Sie auf Veröffentlichen.

Nutzern Zugriff auf einen Eintrag gewähren

Wenn Sie Nutzern Zugriff auf einen privaten Eintrag gewähren möchten, müssen Sie für diese Person eine IAM-Richtlinie oder eine Gruppe für diesen Eintrag festlegen. Bei einem kommerziellen Eintrag muss Ihr Datenaustausch öffentlich sein. Einträge in einem öffentlichen Datenaustausch werden im Analytics Hub für alle Google Cloud-NutzerallAuthenticatedUsers) angezeigt. Damit Nutzer Zugriff auf kommerzielle Einträge anfordern können, müssen Sie ihnen die folgende Berechtigung zuweisen: Rolle "Analytics Hub-Betrachter".

Wenn Sie Ihren Eintrag für alle Nutzer zugänglich machen möchten, auch für Personen, die Google Cloud nicht verwenden, müssen Sie allUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zuweisen.

So gewähren Sie Nutzern Zugriff auf die Anzeige oder das Abonnieren Ihres Eintrags:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

3. Klicken Sie auf den Eintrag, für den Sie Abonnenten hinzufügen möchten.

4. Klicken Sie auf Berechtigungen festlegen.

5. Klicken Sie zum Hinzufügen von Hauptkonten auf Hauptkonto hinzufügen.

6. Fügen Sie im Feld Neue Hauptkonten die folgenden Details je nach Art des Eintrags hinzu:

   • Geben Sie für einen privaten Eintrag E-Mails der Identität ein, der Sie Zugriff gewähren möchten.

   • Fügen Sie für einen öffentlichen Eintrag allAuthenticatedUsers hinzu.

   • Wenn ein öffentlicher Eintrag für alle Nutzer sichtbar sein soll, auch Nutzer ohne Google Cloud, fügen Sie allUsers hinzu.

7. Halten Sie unter Rolle auswählen den Mauszeiger auf Analytics Hub. Wählen Sie dann abhängig vom Typ des Eintrags eine der folgenden Rollen aus:

   • Wählen Sie für einen kommerziellen Eintrag die Rolle Analytics Hub-Betrachter aus. Mit dieser Rolle können Nutzer den Eintrag ansehen und Zugriff anfordern.

   • Wählen Sie für einen privaten oder nicht kommerziellen öffentlichen Eintrag die Rolle Analytics Hub-Abonnent aus. Mit dieser Rolle können Nutzer Ihren Eintrag abonnieren.

   Weitere Informationen finden Sie unter Analytics Hub-Abonnenten- und -Betrachterrollen.

8. Klicken Sie auf Speichern.

API

1. Lesen Sie die vorhandene Richtlinie mit der Eintragsmethode getIamPolicy. Verwenden Sie dazu die Methode projects.locations.dataExchanges.listings.getIamPolicy:

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
   

   Ersetzen Sie dabei Folgendes:

   • PROJECT_ID: die Projekt-ID, z. B. my-project-1.
   • LOCATION: der Standort des Datenpools, der den Eintrag enthält.
   • DATAEXCHANGE_ID: die Datenpool-ID.
   • LISTING_ID: die ID des Eintrags.

   Analytics Hub gibt die aktuelle Richtlinie in der Antwort zurück.

2. Wenn Sie Mitglieder und ihre zugehörigen Rollen hinzufügen oder entfernen möchten, bearbeiten Sie die Richtlinie in einem Texteditor. Verwenden Sie das folgende Format, um Mitglieder hinzuzufügen:

   • user:[e-mail]
   • group:[e-mail]
   • serviceAccount:[e-mail]
   • domain:example.domain.com

   Fügen Sie der Richtlinie beispielsweise die folgende Bindung hinzu, um group:[e-mail] die Rolle roles/analyticshub.subscriber zuzuweisen:

   {
    "members": [
      "group:[e-mail]"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Verwenden Sie die Methode projects.locations.dataExchanges.listings.setIamPolicy, um die aktualisierte Richtlinie zu schreiben. Geben Sie im Anfragetext die aktualisierte IAM-Richtlinie aus dem vorherigen Schritt an.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy
   

   Geben Sie im Anfragetext die Eintragsdetails an. Wenn die Anfrage erfolgreich ist, enthält der Antworttext Details zum Eintrag.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Hinweis: Nachdem Sie Nutzern Lizenzen gewährt haben, um auf Ihren kommerziellen Eintrag zuzugreifen, haben Sie entweder die Möglichkeit, für diese Nutzer einen privaten Eintrag zu erstellen oder ihnen die Rolle Analytics Hub-Abonnent für Ihren kommerziellen Eintrag zuzuweisen.

Nicht authentifizierte URL für einen öffentlichen Eintrag erstellen

So erstellen Sie eine nicht authentifizierte Analytics Hub-Eintrags-URL, die auch für Nutzer ohne Google Cloud sichtbar ist:

1. Rufen Sie 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, der den Eintrag enthält.

3. Klicken Sie auf den Anzeigenamen, um die Eintragsdetails aufzurufen. Für den Eintrag muss die öffentliche Sichtbarkeit aktiviert sein.

4. Klicken Sie auf Öffentlichen Link kopieren, um eine nicht authentifizierte URL für den Eintrag zu generieren. Durch diesen Eintrag muss allUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) gewährt werden.

Eintragadministrator erstellen

Damit Nutzer Einträge verwalten können, müssen Sie Analytics Hub-Eintragsadministratoren erstellen. Zum Erstellen von Eintragsadministratoren müssen Sie Nutzern auf Eintragsebene die Rolle "Analytics Hub-Publisher" oder "Analytics Hub-Eintragsadministrator" zuweisen. Weitere Informationen zum Zuweisen dieser Rollen für einen Eintrag finden Sie unter Rolle für einen Eintrag zuweisen.

Alle Abos ansehen

Wählen Sie eine der folgenden Optionen aus, um alle aktuellen Abos Ihres Eintrags aufzurufen:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält, für den Sie Abos verwalten möchten.

3. Klicken Sie auf den Eintrag, für den Sie alle Abonnenten auflisten möchten.

4. Wenn Sie alle Abonnenten Ihres Eintrags aufrufen möchten, klicken Sie auf Abos verwalten.

   

5. Optional: Du kannst die Ergebnisse nach Abonnentendetails filtern.

Wenn du Zugriff auf das freigegebene Dataset hast, kannst du Abonnenten auch so auflisten:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und wählen Sie das freigegebene Dataset aus.

3. Wählen Sie in der Liste Teilen die Option Abos verwalten aus.

SQL

Im folgenden Beispiel wird die Ansicht INFORMATION_SCHEMA.SCHEMATA_LINKS verwendet, um alle verknüpften Datasets mit einem freigegebenen Dataset in myproject aufzulisten, die sich in der Region us befinden:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

Die entsprechende Ausgabe sieht etwa so aus: Einige Spalten werden weggelassen, um die Ausgabe zu vereinfachen.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

Verwenden Sie die Methode projects.locations.dataExchanges.listings.listSubscriptions.

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

Ersetzen Sie dabei Folgendes:

• PROJECT_ID: die Projekt-ID des Eintrags, den Sie abonnieren möchten.
• LOCATION: der Standort für Ihren Eintrag, den Sie abonnieren möchten.
• DATAEXCHANGE_ID: die Datenaustausch-ID, die den Eintrag enthält, den Sie abonnieren möchten.
• LISTING_ID: die ID des Eintrags, den Sie abonnieren möchten.

Abos entfernen

Wenn Sie ein vor dem 25. Juli 2023 erstelltes Abo aus Ihren Listen entfernen, wird das verknüpfte Dataset vom freigegebenen Dataset getrennt. Abonnenten können die Datasets weiterhin in ihren Projekten sehen, sind aber nicht mehr mit dem freigegebenen Dataset verknüpft.

So entfernen Sie ein Abo, das vor dem 25. Juli 2023 erstellt wurde, aus Ihren Einträgen:

1. Folgen Sie der Anleitung in der Google Cloud Console unter Alle Abos ansehen, um alle Abonnenten eines Eintrags aufzulisten.

2. Wenn Sie einen Abonnenten aus einem Eintrag entfernen möchten, klicken Sie auf Löschen. Wenn Sie alle Abos entfernen möchten, klicken Sie auf Alle Abos entfernen.

3. Geben Sie im Dialogfeld Abo entfernen? remove ein, um den Vorgang zu bestätigen.

4. Klicken Sie auf Entfernen.

So entfernen Sie Abos, die nach dem 25. Juli 2023 erstellt wurden:

Console

1. Folgen Sie der Anleitung in der Google Cloud Console unter Alle Abos ansehen, um alle Abonnenten eines Eintrags aufzulisten.

2. Klicken Sie auf den Tab Abos.

3. Wählen Sie zum Entfernen eines Abonnenten aus dem Eintrag die zu entfernenden Abos aus und klicken Sie auf Abos entfernen.

4. Geben Sie im Dialogfeld Abo entfernen? remove ein, um den Vorgang zu bestätigen.

5. Klicken Sie auf Entfernen.

API

Verwenden Sie die Methode projects.locations.subscriptions.revoke (Vorschau).

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

Ersetzen Sie dabei Folgendes:

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

Eintrag aktualisieren

So aktualisieren Sie einen Eintrag:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

3. Klicken Sie auf den Eintrag, den Sie aktualisieren möchten.

4. Klicken Sie auf Eintrag bearbeiten.

5. Ändern Sie die Werte in den Feldern. Sie können alle Werte mit Ausnahme des Quell-Datasets des Eintrags ändern.

6. Optional:

   • Wenn Sie die öffentliche Sichtbarkeit aktivieren, weisen Sie allUsers oder allAuthenticatedUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zu. Weitere Informationen finden Sie unter Rolle für einen Eintrag zuweisen.
   • Wenn Sie die öffentliche Sichtbarkeit deaktivieren, entfernen Sie die Rolle „Analytics Hub-Betrachter“ aus allUsers und allAuthenticatedUsers. Öffentliche Anzeigenplattformen können keine privaten Einträge haben, private Anzeigenplattformen können jedoch öffentliche Einträge haben.

7. Klicken Sie auf Vorschau, um eine Vorschau der Änderungen anzuzeigen.

8. Klicken Sie auf Save (Speichern), um die Änderungen zu speichern.

API

Verwenden Sie die Methode projects.locations.dataExchanges.listings.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

Ersetzen Sie UPDATEMASK durch die Liste der Felder, die Sie aktualisieren möchten. Verwenden Sie zum Aktualisieren mehrerer Werte eine durch Kommas getrennte Liste. Geben Sie im Anfragetext die aktualisierten Werte an.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Eintrag löschen

Wenn Sie einen Eintrag löschen, können Abonnenten diesen Eintrag nicht mehr aufrufen. Wenn Sie einen Eintrag löschen, werden auch alle verknüpften Datasets aus den Projekten Ihrer Abonnenten gelöscht (alle Abos werden entfernt).

Hinweis: Wenn ein Dataset weiterhin verknüpft ist, entfernen Sie es manuell. Klicken Sie dazu auf  Teilen > Abo verwalten. Die Seite Abos wird geöffnet. Dort können Sie ein bestimmtes Abo-Dataset oder alle Abo-Datasets gleichzeitig entfernen.

Wenn Sie einen Eintrag löschen, kann er nicht rückgängig gemacht werden. So löschen Sie einen Eintrag:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

3. Klicken Sie auf den Eintrag, den Sie löschen möchten.

4. Klicken Sie auf Löschen.

5. Bestätigen Sie im Dialogfeld Eintrag löschen? den Löschvorgang, indem Sie Löschen eingeben.

6. Klicken Sie auf Löschen.

API

Verwenden Sie die Methode projects.locations.dataExchanges.listings.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Einen Eintrag im Abschnitt "Empfohlen" anzeigen

Um die Sichtbarkeit und Bekanntheit Ihres Eintrags im Analytics Hub-Katalog zu verbessern, können Einträge im Abschnitt Angesagt angezeigt werden. Die empfohlenen Einträge unterliegen der Google Cloud Partner Advantage-Vereinbarung.

Partner, die daran interessiert sind, dass ihre Einträge im Abschnitt Angesagt des Analytics Hub-Katalogs aufgeführt werden, müssen die folgenden Kriterien erfüllen:

• Freigegebene Daten müssen sich in BigQuery befinden.

• Sie müssen für das Partner Advantage-Programm mit der Build-Kennzeichnung angemeldet sein.

• Der Eintrag muss erstellt werden und die öffentliche Sichtbarkeit muss aktiviert sein.

Wenn Sie beantragen möchten, dass Ihr Eintrag im Abschnitt Angesagt erscheint, füllen Sie das Aufnahmeformular aus und reichen Sie es ein. Wenn Sie beantragen möchten, dass Ihr Eintrag aus dem Abschnitt entfernt wird, reichen Sie dasselbe Aufnahmeformular ein.

Nächste Schritte

• Mehr über die Analytics Hub-Architektur erfahren
• Informationen zum Aufrufen und Abonnieren von Einträgen
• Weitere Informationen zu Analytics Hub-Nutzerrollen
• Datasets erstellen
• Audit-Logging in Analytics Hub
• Einträge überwachen