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.

Bevor Sie Daten aktivieren, 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 Sie die Flow Service API.

HINWEIS

Das Löschen von Zielkonten wird derzeit nur in der Flow Service-API unterstützt. Zielkonten können nicht über die Experience Platform-Benutzeroberfläche gelöscht werden.

Erste Schritte

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 der Zielkatalog und führen Sie die Schritte aus, die beschrieben wurden, um Verbindung zum Ziel herstellen vor dem Versuch dieses Tutorials.

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

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um ein Zielkonto mit der Flow Service API.

Lesen von Beispiel-API-Aufrufen

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

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}
HINWEIS

Wenn die Variable x-sandbox-name -Kopfzeile nicht angegeben ist, werden Anfragen unter der prod Sandbox.

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

HINWEIS

In diesem Tutorial wird die Bestimmungsort des Luftschiffes Beispiel: Die beschriebenen Schritte gelten jedoch für alle verfügbare Ziele.

Der erste Schritt beim Löschen eines Zielkontos besteht darin, die Verbindungs-ID zu ermitteln, 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 Konto aus, das Sie löschen möchten, indem Sie die Nummer im Ziele Spalte.

Zielkonto zum Löschen auswählen

Als Nächstes können Sie die Verbindungs-ID des Zielkontos aus der URL in Ihrem Browser abrufen.

Verbindungs-ID von URL abrufen

Verbindung löschen

WICHTIG

Bevor Sie das Zielkonto löschen, müssen Sie alle vorhandenen Datenflüsse zum Zielkonto löschen.
Informationen zum Löschen vorhandener Datenflüsse finden Sie auf den folgenden Seiten:

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.

API-Format

DELETE /connections/{CONNECTION_ID}
Parameter Beschreibung
{CONNECTION_ID} Die eindeutige 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 einen HTTP 404-Fehler (Nicht gefunden) zurück, der angibt, dass das Zielkonto gelöscht wurde.

Umgang mit API-Fehlern

Die API-Endpunkte in diesem Tutorial folgen den allgemeinen Grundsätzen für die Fehlermeldung bei der Experience Platform-API. 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 erfolgreich die Flow Service API zum Löschen vorhandener Zielkonten. Weiterführende Informationen zur Verwendung von Zielen finden Sie im Abschnitt Ziele - Übersicht.

Auf dieser Seite