[Ultimate]{class="badge positive"}
Erstellen eines Quell-Connectors für Google PubSub in der Benutzeroberfläche
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
Sie müssen Werte für die unten beschriebenen Verbindungseigenschaften angeben, um Ihr PubSub-Konto mit Experience Platform zu verbinden. Weitere Informationen zur Authentifizierung und zur Einrichtung der Voraussetzungen finden Sie in der PubSub source Übersicht.
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Anmeldedaten | Beschreibung |
Projekt-ID | Die zur Authentifizierung von PubSub erforderliche Projekt-ID. |
Anmeldeinformationen | Die zum Authentifizieren von PubSub erforderliche Berechtigung. Sie müssen sicherstellen, dass Sie die vollständige JSON-Datei platzieren, nachdem Sie die Leerzeichen aus Ihren Anmeldedaten entfernt haben. |
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Anmeldedaten | Beschreibung |
Anmeldeinformationen | Die zum Authentifizieren von PubSub erforderliche Berechtigung. 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-Abonnements. In PubSub ermöglichen Abonnements den Empfang von Nachrichten, indem Sie das Thema abonnieren, in dem Nachrichten veröffentlicht wurden. Hinweis: Ein einzelnes PubSub Abonnement kann 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-Abonnements. In PubSub ermöglichen Abonnements den Empfang von Nachrichten, indem Sie das Thema abonnieren, 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.
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. Der Bildschirm Katalog enthält verschiedene Quellen, 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.
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.
Neues Konto
- 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 einer Basis-Verbindung vom Typ Google PubSub nicht mehr ändern. 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 Ihr neues PubSub-Konto ein.
Mit der Quelle PubSub 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. Mit der projektbasierten Authentifizierung können Sie Zugriff auf das Stammprojekt in Ihrem Konto gewähren, während die Themen- und Abonnementbasierte Authentifizierung den Zugriff auf ein bestimmtes Thema und ein bestimmtes Abonnement beschränken kann.PubSub
So erstellen Sie ein Konto mit Zugriff auf Ihren Stammordner für PubSub -Projekte. Wählen Sie Google PubSub-Authentifizierungsberechtigungen als Authentifizierungstyp aus und geben Sie Ihre Projekt-ID und Ihre Anmeldeinformationen ein. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.
Um ein Konto mit eingeschränktem Zugriff auf ein bestimmtes Thema und ein bestimmtes Abonnement zu erstellen, wählen Sie Google PubSub Scoped authentication credentials und geben Sie dann Ihre Anmeldeinformationen, den Themennamen und/oder den Abonnementnamen ein. PubSub Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.
Daten auswählen
Bei erfolgreicher Authentifizierung gelangen Sie zum Schritt Daten auswählen , in dem Sie durch Ihre PubSub-Datenhierarchie navigieren und die Daten auswählen können, die Sie an Experience Platform übermitteln möchten.
Wenn Sie sich beim projektbasierten Zugriff authentifiziert haben, zeigt die Benutzeroberfläche Daten auswählen alle Abonnements in Ihrem Projekt an, denen ein Thema angehängt ist.
Wenn Sie sich mit einem Thema und einem Abonnementzugriff authentifiziert haben, kann die Anzeige der Benutzeroberfläche Daten auswählen 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.
Nächste Schritte
In diesem Tutorial haben Sie eine Verbindung zwischen Ihrem PubSub-Konto und Platform hergestellt. 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.