Der Google PubSub-Anschluss befindet sich in der Betaversion. Weitere Informationen zur Verwendung von Beta-gekennzeichneten Connectors finden Sie unter Sources overview.
Dieses Lernprogramm verwendet die APIFlow Service um Sie durch die Schritte zu führen, die notwendig sind, um Google PubSub (nachfolgend "a3/>") mit Adobe Experience Platform zu verbinden. PubSub
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 mit der Flow Service-API eine PubSub-Quellverbindung erfolgreich zu erstellen.
Damit Flow Service eine Verbindung zu PubSub herstellen kann, müssen Sie Werte für die folgenden Verbindungseigenschaften angeben:
Berechtigung | Beschreibung |
---|---|
projectId |
Die Projekt-ID, die zum Authentifizieren von PubSub erforderlich ist. |
credentials |
Die Berechtigung oder der Schlüssel, die für die Authentifizierung von PubSub erforderlich ist. |
Weitere Informationen zu diesen Werten finden Sie im folgenden Dokument PubSub authentication. Wenn Sie die dienstkontobasierte Authentifizierung verwenden, finden Sie im folgenden Handbuch PubSub Anweisungen zum Generieren Ihrer Anmeldeinformationen.
Wenn Sie die kontobasierte Authentifizierung eines Dienstes verwenden, stellen Sie sicher, dass Sie ausreichend Benutzerzugriff auf Ihr Dienstkonto gewährt haben und dass keine zusätzlichen Leerzeichen im JSON vorhanden sind, wenn Sie Ihre Anmeldeinformationen kopieren und einfügen.
In diesem Tutorial wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. Dazu gehören Pfade, erforderliche Kopfzeilen und ordnungsgemäß formatierte Anfrage-Payloads. Außerdem wird ein Beispiel für eine von der API im JSON-Format zurückgegebene Antwort bereitgestellt. Informationen zu den Konventionen, die in der Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Handbuch zur Fehlerbehebung für Experience Platform.
Um Platform-APIs aufrufen zu können, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen. Im Rahmen des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Kopfzeilen in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
Alle Ressourcen in Experience Platform, einschließlich der Ressourcen von Flow Service, werden zu bestimmten virtuellen Sandboxen isoliert. Bei allen Anfragen an Platform-APIs ist eine Kopfzeile erforderlich, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt werden soll:
x-sandbox-name: {SANDBOX_NAME}
Bei allen Anfragen, die eine Payload enthalten (POST, PUT, PATCH), ist eine zusätzliche Medientyp-Kopfzeile erforderlich:
Content-Type: application/json
Eine Verbindung gibt eine Quelle an und enthält Ihre Anmeldeinformationen für diese Quelle. Pro PubSub-Konto ist nur eine Verbindung erforderlich, da sie zum Erstellen mehrerer Datenflüsse verwendet werden kann, um verschiedene Daten einzubringen.
API-Format
POST /connections
Anfrage
Um eine PubSub-POST zu erstellen, müssen die Anbieter-ID und die Verbindungs-ID als Teil der Anforderung angegeben werden. Die Anbieter-ID ist 521eee4d-8cbe-4906-bb48-fb6bd4450033
und die Verbindungs-ID ist 70116022-a743-464a-bbfe-e226a7f8210c
.
API-Format
POST /connections
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: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Google PubSub connection",
"description": "Google PubSub connection",
"providerId": "521eee4d-8cbe-4906-bb48-fb6bd4450033",
"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 Projekt-ID, die zum Authentifizieren von PubSub erforderlich ist. |
auth.params.credentials |
Die Berechtigung oder der Schlüssel, die für die Authentifizierung von PubSub erforderlich ist. |
connectionSpec.id |
Die PubSub-Verbindungs-Spec-ID: 70116022-a743-464a-bbfe-e226a7f8210c . |
Antwort
Eine erfolgreiche Antwort gibt die Verbindungs-ID der neu erstellten PubSub-Verbindung zurück. Diese ID ist erforderlich, um Ihre Cloud-Datenspeicherung-Daten im nächsten Lernprogramm zu untersuchen.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}
In diesem Lernprogramm haben Sie eine PubSub-Verbindung mit der Flow Service-API erstellt und die eindeutige Verbindungs-ID erhalten. Sie können diese Verbindungs-ID verwenden, um Streaming-Daten mit der Flow Service API](…/…/collect/streaming.md) zu erfassen.[