Löschen eines Zielkontos mithilfe der Flow Service-API
Destinations sind vorkonfigurierte Integrationen mit Zielplattformen, die eine nahtlose Aktivierung von Daten aus Adobe Experience Platform ermöglichen. Mit Zielen können Sie Ihre bekannten und unbekannten Daten für kanalübergreifende Marketing-Kampagnen, E-Mail-Kampagnen, zielgruppengerechte Werbung und viele andere Anwendungsfälle aktivieren.
Vor der Aktivierung von Daten müssen Sie eine Verbindung zum Ziel herstellen, indem Sie zunächst ein Zielkonto einrichten. In diesem Tutorial werden die Schritte zum Löschen von Zielkonten beschrieben, die nicht mehr benötigt werden, indem die -Flow Service verwendet.
Erste Schritte get-started
Für dieses Tutorial benötigen Sie eine gültige Verbindungs-ID. Die Verbindungs-ID stellt die Kontoverbindung zum Ziel dar. Wenn Sie keine gültige Verbindungs-ID haben, wählen Sie Ihr Ziel aus dem Zielkatalog und führen Sie die zum Herstellen einer mit dem Ziel beschriebenen Schritte aus,Sie dieses Tutorial ausführen.
Dieses Tutorial setzt außerdem ein Grundverständnis der folgenden Komponenten von Adobe Experience Platform voraus:
- Ziele: Destinations sind vorkonfigurierte Integrationen mit Zielplattformen, die eine nahtlose Aktivierung von Daten aus Adobe Experience Platform ermöglichen. Mit Zielen können Sie Ihre bekannten und unbekannten Daten für kanalübergreifende Marketing-Kampagnen, E-Mail-Kampagnen, zielgruppengerechte Werbung und viele andere Anwendungsfälle aktivieren.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln können.
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um ein Zielkonto mithilfe der Flow Service-API erfolgreich löschen zu können.
Lesen von Beispiel-API-Aufrufen reading-sample-api-calls
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
Sammeln von Werten für erforderliche Kopfzeilen gather-values-for-required-headers
Um Platform-APIs aufzurufen, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen. Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Header in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alle Ressourcen in Experience Platform, einschließlich der Ressourcen, die zu Flow Service gehören, werden in bestimmten virtuellen Sandboxes 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}
x-sandbox-name-Kopfzeile nicht angegeben ist, werden Anfragen unter der prod-Sandbox aufgelöst.Bei allen Anfragen, die eine Payload enthalten (POST, PUT, PATCH), ist eine zusätzliche Medientyp-Kopfzeile erforderlich:
Content-Type: application/json
Suchen Sie die Verbindungs-ID des Zielkontos, das Sie löschen möchten find-connection-id
Der erste Schritt beim Löschen eines Zielkontos besteht darin, die Verbindungs-ID herauszufinden, die dem Zielkonto entspricht, das Sie löschen möchten.
Navigieren Sie in der Experience Platform-Benutzeroberfläche zu Ziele > Konten und wählen Sie das zu löschende Konto aus, indem Sie die Zahl in der Spalte Ziele auswählen.
Als Nächstes können Sie die Verbindungs-ID des Zielkontos über die URL in Ihrem Browser abrufen.
Verbindung löschen delete-connection
Informationen zum Löschen vorhandener Datenflüsse finden Sie auf den folgenden Seiten:
- Verwenden der Experience Platform- zum Löschen vorhandener Datenflüsse
- Verwenden der Flow Service-API um vorhandene Datenflüsse zu löschen.
Nachdem Sie über eine Verbindungs-ID verfügen und sichergestellt haben, dass keine Datenflüsse zum Zielkonto vorhanden sind, führen Sie eine DELETE-Anfrage an die Flow Service-API aus.
API-Format
DELETE /connections/{CONNECTION_ID}
{CONNECTION_ID}id für die Verbindung, die Sie löschen möchten.Anfrage
curl -X DELETE \
'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
-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}'
Antwort
Eine erfolgreiche Antwort gibt den HTTP-Status 204 (Kein Inhalt) und leeren Text zurück. Sie können den Löschvorgang bestätigen, indem Sie eine Suchanfrage (GET) an die Verbindung stellen. Die API gibt den HTTP-404-Fehler (Nicht gefunden) zurück, der angibt, dass das Zielkonto gelöscht wurde.
Umgang mit API-Fehlern api-error-handling
Die API-Endpunkte in diesem Tutorial folgen den allgemeinen Grundsätzen für Experience Platform-API-Fehlermeldungen. Siehe API-Status-Codes und Fehler im Anfrage-Header in der Anleitung zur Fehlerbehebung für Platform.
Nächste Schritte
In diesem Tutorial haben Sie die Flow Service-API erfolgreich zum Löschen vorhandener Zielkonten verwendet. Weitere Informationen zur Verwendung von Zielen finden Sie unter Ziele - Übersicht.