Dieses Tutorial führt Sie durch die Schritte zum Verbinden Google PubSub (nachstehend „PubSub“ genannt) mit Experience Platform mithilfe der Flow Service API.
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um PubSub mithilfe der Flow Service-API erfolgreich mit Platform verbinden zu können.
Um Flow Service mit PubSub zu verbinden, müssen Sie Werte für die folgenden Verbindungseigenschaften angeben:
Anmeldedaten | Beschreibung |
---|---|
projectId |
Die zur Authentifizierung von PubSub erforderliche Projekt-ID. |
credentials |
Die zum Authentifizieren von PubSub erforderlichen Anmeldedaten bzw. der erforderliche Schlüssel. |
connectionSpec.id |
Die Verbindungsspezifikation gibt die Connector-Eigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen im Zusammenhang mit der Erstellung der Datenbank- und Quelle-Ziel-Verbindungen. Die Spezifikations-ID der PubSub-Verbindung lautet: 70116022-a743-464a-bbfe-e226a7f8210c . |
Weitere Informationen zu diesen Werten finden Sie in diesem Dokument zur PubSub Authentifizierung. Informationen zur Verwendung der auf Service-Konten basierenden Authentifizierung finden Sie in diesem PubSub Handbuch zum Erstellen von Service-Konten in den Schritten zum Erstellen von Anmeldedaten.
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.
Informationen zum Aufrufen von Platform-APIs finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.
Der erste Schritt beim Erstellen einer Quellverbindung besteht darin, Ihre PubSub-Quelle zu authentifizieren und eine Basisverbindungs-ID zu generieren. Mittels einer Basisverbindungs-ID können Sie Dateien aus Ihrer Quelle durchsuchen, zwischen Dateien innerhalb der Quelle navigieren und bestimmte Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu Datentypen und Formaten.
Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den /connections
-Endpunkt beim Bereitstellen der PubSub-Authentifizierungsberechtigungsdaten als Teil der Anfrageparameter.
API-Format
POST /connections
Anfrage
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Google PubSub connection",
"description": "Google PubSub connection",
"auth": {
"specName": "Google PubSub authentication credentials",
"params": {
"projectId": "{PROJECT_ID}",
"credentials": "{CREDENTIALS}"
}
},
"connectionSpec": {
"id": "70116022-a743-464a-bbfe-e226a7f8210c",
"version": "1.0"
}
}'
Eigenschaft | Beschreibung |
---|---|
auth.params.projectId |
Die zur Authentifizierung von PubSub erforderliche Projekt-ID. |
auth.params.credentials |
Die zur Authentifizierung von PubSub erforderlichen Anmeldeinformationen bzw. der Schlüssel. |
connectionSpec.id |
Die PubSub-Verbindungsspezifikations-ID: 70116022-a743-464a-bbfe-e226a7f8210c . |
Antwort
Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id
). Diese Basisverbindungs-ID wird im nächsten Schritt benötigt, um eine Quellverbindung zu erstellen.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}
Eine Quellverbindung erstellt und verwaltet die Verbindung zu der externen Quelle, aus der Daten erfasst werden. Eine Quellverbindung besteht aus Informationen wie Datenquelle, Datenformat und einer Quell-Verbindungs-ID, die zum Erzeugen eines Datenflusses erforderlich sind. Eine Quellverbindungsinstanz ist für einen Mandanten und eine IMS-Organisation spezifisch.
Um eine Quellverbindung zu erstellen, stellen Sie eine POST-Anfrage an den /sourceConnections
-Endpunkt der Flow Service-API.
API-Format
POST /sourceConnections
Anfrage
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "Google PubSub source connection",
"description": "A source connection for Google PubSub",
"baseConnectionId": "4cb0c374-d3bb-4557-b139-5712880adc55",
"connectionSpec": {
"id": "70116022-a743-464a-bbfe-e226a7f8210c",
"version": "1.0"
},
"data": {
"format": "json"
},
"params": {
"topicId": "{TOPIC_ID}",
"subscriptionId": "{SUBSCRIPTION_ID}",
"dataType": "raw"
}
}'
Eigenschaft | Beschreibung |
---|---|
name |
Der Name Ihrer Quellverbindung. Stellen Sie sicher, dass der Name Ihrer Quellverbindung beschreibend ist, da Sie damit Informationen zu Ihrer Quellverbindung nachschlagen können. |
description |
Ein optionaler Wert, den Sie angeben können, um weitere Informationen zu Ihrer Quellverbindung einzuschließen. |
baseConnectionId |
Die ID der Basisverbindung Ihrer PubSub-Quelle, die im vorhergehenden Schritt generiert wurde. |
connectionSpec.id |
Die feste Verbindungsspezifikations-ID für PubSub. Diese ID lautet: 70116022-a743-464a-bbfe-e226a7f8210c |
data.format |
Das Format der PubSub-Daten, die Sie aufnehmen möchten. Derzeit wird nur das Datenformat json unterstützt. |
params.topicId |
Die Themen-ID definiert die spezifische benannte Ressource, an die Nachrichten von Publishern gesendet werden |
params.subscriptionId |
Die Abonnement-ID definiert die spezifische benannte Ressource, die den Nachrichtenstrom von einem einzelnen, spezifischen Thema darstellt, der an das abonnierende Programm geliefert werden soll. |
params.dataType |
Dieser Parameter definiert den Typ der aufgenommenen Daten. Zu den unterstützten Datentypen gehören: raw und xdm . |
Antwort
Eine erfolgreiche Antwort gibt die eindeutige Kennung (id
) der neu erstellten Quellverbindung zurück. Diese ID ist im nächsten Tutorial zum Erstellen eines Datenflusses erforderlich.
{
"id": "e96d6135-4b50-446e-922c-6dd66672b6b2",
"etag": "\"66013508-0000-0200-0000-5f6e2ae70000\""
}
In diesem Tutorial haben Sie eine PubSub-Quellverbindung mithilfe der Flow Service-API erstellt. Sie können diese Quellverbindungs-ID im nächsten Tutorial verwenden, um einen Streaming-Datenfluss mit der Flow Service -API zu erstellen.