Ultimate

Erstellen eines Quell-Connectors für Google PubSub in der Benutzeroberfläche

Letzte Aktualisierung: 2023-10-26
  • Themen:
  • Sources
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • Developer
    User
    Admin
    Leader
WICHTIG

Die Google PubSub -Quelle ist im Quellkatalog für Benutzer verfügbar, die Real-time Customer Data Platform Ultimate erworben haben.

In diesem Tutorial werden Schritte zum Erstellen eines Google PubSub (nachstehend „PubSub“ genannt) in der Benutzeroberfläche von Platform beschrieben.

Erste Schritte

Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Adobe Experience Platform voraus:

  • Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
  • Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.

Wenn Sie bereits über eine gültige PubSub-Verbindung verfügen, können Sie den Rest dieses Dokuments überspringen und mit dem Tutorial zum Konfigurieren eines Datenflusses fortfahren.

Sammeln erforderlicher Anmeldeinformationen

Um eine Verbindung von PubSub mit Platform herzustellen, müssen Sie einen gültigen Wert für die folgenden Anmeldeinformationen angeben:

Anmeldedaten Beschreibung
Projekt-ID Die zur Authentifizierung von PubSub erforderliche Projekt-ID.
Anmeldeinformationen Die zum Authentifizieren erforderliche Berechtigung PubSub. Sie müssen sicherstellen, dass Sie die vollständige JSON-Datei platzieren, nachdem Sie die Leerzeichen aus Ihren Anmeldedaten entfernt haben.
Anmeldedaten Beschreibung
Anmeldeinformationen Die zum Authentifizieren erforderliche Berechtigung PubSub. Sie müssen sicherstellen, dass Sie die vollständige JSON-Datei platzieren, nachdem Sie die Leerzeichen aus Ihren Anmeldedaten entfernt haben.
Themenname Der Name Ihres PubSub Abonnement. In PubSub, können Sie über Abonnements Nachrichten empfangen, indem Sie sich für das Thema anmelden, in dem Nachrichten veröffentlicht wurden. Hinweis: Eine einzelne PubSub Abonnements können nur für einen Datenfluss verwendet werden. Um mehrere Datenflüsse erstellen zu können, müssen Sie über mehrere Abonnements verfügen.
Abonnementname Der Name Ihres PubSub Abonnement. In PubSub, können Sie über Abonnements Nachrichten empfangen, indem Sie sich für das Thema anmelden, in dem Nachrichten veröffentlicht wurden.

Weitere Informationen zu diesen Werten finden Sie im folgenden Dokument PubSub-Authentifizierung. Wenn Sie die auf dem Service-Account basierende Authentifizierung verwenden, lesen Sie das folgende PubSub-Handbuch, in dem die Schritte zum Generieren Ihrer Anmeldeinformationen beschrieben werden.

TIPP

Wenn Sie die auf Service-Konten basierende Authentifizierung verwenden, stellen Sie sicher, dass Sie einen ausreichenden Benutzerzugriff auf Ihr Service-Konto gewährt haben und dass in JSON keine zusätzlichen Leerzeichen vorhanden sind, wenn Sie Ihre Anmeldeinformationen kopieren und einfügen.

Nachdem Sie die erforderlichen Anmeldeinformationen zusammen haben, können Sie die folgenden Schritte ausführen, um Ihr PubSub-Konto mit Platform zu verknüpfen.

Verbinden Sie Ihr PubSub-Konto

Wählen Sie in der Platform-Benutzeroberfläche in der linken Navigationsleiste die Option Quellen, um auf den Arbeitsbereich Quellen zuzugreifen. Die Katalog zeigt eine Vielzahl von Quellen an, mit denen Sie ein Konto erstellen können.

Sie können die gewünschte Kategorie aus dem Katalog auf der linken Bildschirmseite auswählen. Alternativ können Sie die gewünschte Quelle mithilfe der Suchoption finden.

Wählen Sie unter der Kategorie Cloud-Speicherplatz die Option Google PubSub und dann die Option Daten hinzufügen aus.

Der Quellkatalog auf der Experience Platform-Benutzeroberfläche.

Die Seite Verbinden mit Google PubSub wird angezeigt. Auf dieser Seite können Sie entweder neue oder vorhandene Anmeldedaten verwenden.

Vorhandenes Konto

Um ein vorhandenes Konto zu verwenden, wählen Sie das PubSub-Konto, mit dem Sie einen neuen Datenfluss erstellen möchten, und klicken Sie dann auf Weiter, um fortzufahren.

Die vorhandene Kontoauswahl im Ursprungs-Workflow.

Neues Konto

TIPP
  • Beim Erstellen eines Kontos mit eingeschränktem Zugriff müssen Sie mindestens einen Namen für Ihr Thema oder Ihren Abonnementnamen angeben. Die Authentifizierung schlägt fehl, wenn beide Werte fehlen.
  • Nach der Erstellung können Sie den Authentifizierungstyp eines Google PubSub Basisverbindung. Um den Authentifizierungstyp zu ändern, müssen Sie eine neue Basisverbindung erstellen.

Wenn Sie ein neues Konto erstellen, wählen Sie Neues Konto und geben Sie dann einen Namen und eine optionale Beschreibung für Ihre neue PubSub -Konto.

Die neue Kontoschnittstelle für die Google PubSub-Quelle im Quellen-Workflow

Die PubSub -Quelle können Sie den Zugriffstyp angeben, den Sie während der Authentifizierung zulassen möchten. Sie können Ihr Konto so einrichten, dass es entweder über eine projektbasierte Authentifizierung oder über Themen- und Abonnement-basierte Authentifizierung verfügt. Projektbasierte Authentifizierung ermöglicht es Ihnen, Zugriff auf das Projekt auf der Stammebene in Ihrem Konto zu gewähren, während die Themen- und Abonnementbasierte Authentifizierung den Zugriff auf eine bestimmte PubSub Thema und Abonnement.

So erstellen Sie ein Konto mit Zugriff auf Ihren Stammordner PubSub Projektordner. Auswählen Google PubSub-Authentifizierungsberechtigungen als Authentifizierungstyp verwenden und Ihre Projekt-ID und Anmeldeinformationen angeben. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.

Die neue Kontoschnittstelle für die Google PubSub-Quelle mit ausgewähltem Stammzugriff.

So erstellen Sie ein Konto mit eingeschränktem Zugriff auf eine bestimmte PubSub Thema und Abonnement, wählen Sie Google PubSub Scoped-Authentifizierungsberechtigungen Geben Sie dann Ihre Anmeldeinformationen, den Themennamen und/oder den Abonnementnamen ein. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.

Die neue Kontoschnittstelle für die Google PubSub-Quelle mit aktiviertem Scoped-Zugriff.

HINWEIS

Prinzipal (Rollen), das einem PubSub -Projekt wird in allen Themen und Abonnements übernommen, die innerhalb eines PubSub Projekt. Wenn Sie möchten, dass ein Prinzipal (eine Rolle) Zugriff auf ein bestimmtes Thema hat, muss dieser Prinzipal (die Rolle) auch zum entsprechenden Abonnement des Themas hinzugefügt werden. Weitere Informationen finden Sie im Abschnitt [PubSub Dokumentation zur Zugriffskontrolle] (https://cloud.google.com/pubsub/docs/access-control).

Daten auswählen

Eine erfolgreiche Authentifizierung bringt Sie zu Daten auswählen Schritt, in dem Sie durch Ihre PubSub die Datenhierarchie und wählen Sie die Daten aus, die Sie zum Experience Platform bringen möchten.

Wenn Sie sich beim projektbasierten Zugriff authentifiziert haben, wird die Daten auswählen -Oberfläche zeigt alle Abonnements in Ihrem Projekt an, denen ein Thema angehängt ist.

Der Schritt Datenauswahl des Ursprungs-Workflows mit projektbasierter Authentifizierung.

Wenn Sie sich mit einem Thema und Abonnementzugriff authentifiziert haben, wird die Daten auswählen Die Anzeige der Benutzeroberfläche kann je nach den von Ihnen bereitgestellten Informationen variieren.

  • Wenn Sie nur den Themennamen angeben, zeigt die Benutzeroberfläche alle Themen-Abonnementpaare an, die dem angegebenen Thema entsprechen.
  • Wenn Sie nur den Abonnementnamen angeben, zeigt die Benutzeroberfläche alle Themen-Abonnementpaare an, die dem angegebenen Abonnementnamen entsprechen.
  • Wenn sowohl Themen- als auch Abonnementnamen angegeben sind, zeigt die Benutzeroberfläche das Thema-Abonnement-Paar an, das beiden bereitgestellten Werten entspricht.

Der Schritt "Daten auswählen"des Ursprungs-Workflows mit Themen- und Abonnement-basierter Authentifizierung.

Nächste Schritte

In diesem Tutorial haben Sie eine Verbindung zwischen Ihrer PubSub -Konto und -Plattform. Sie können jetzt mit dem nächsten Tutorial fortfahren und einen Datenfluss konfigurieren, um Streaming-Daten aus Ihrem Cloud-Speicher in Platform zu übertragen.

Auf dieser Seite