Data Hygiene API-Handbuch
Mit der Datenhygiene-API können Sie die in Adobe Experience Platform gespeicherten personenbezogenen Daten Ihrer Kundinnen und Kunden programmgesteuert korrigieren oder löschen sowie Ablaufdaten für Datensätze planen. In diesem Handbuch werden die erforderlichen Schritte zur Verwendung der API beschrieben und Links zu Endpunkt-Dokumentationen bereitgestellt.
Erste Schritte
Sie können über den folgenden Stammpfad auf die Data Hygiene API zugreifen: https://platform.adobe.io/data/core/hygiene/
Im nachfolgenden Abschnitt erhalten Sie eine Einführung in die wichtigsten Konzepte, die Sie kennen sollten, bevor Sie Aufrufe an die API durchführen.
Sammeln von Werten für erforderliche Kopfzeilen
Um die Data Hygiene-API aufrufen zu können, müssen Sie zunächst Ihre Authentifizierungsdaten erfassen. Folgen Sie den Schritten im API-Authentifizierungs-Handbuch, um wie unten dargestellt Werte für die einzelnen Kopfzeilen zu generieren, die für die Data Hygiene API erforderlich sind:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Bei allen Anfragen mit einer Payload (POST, PUT, PATCH) ist eine zusätzliche Kopfzeile erforderlich:
Content-Type: application/json
Lesen von Beispiel-API-Aufrufen
In diesem Dokument wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. 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 in den Ersten Schritten für Experience Platform-APIs.
Datensatzgültigkeiten
Eine Datensatzgültigkeit ist eine zeitverzögerte Aktion zum Löschen eines Datensatzes. Beim Erstellen einer Datensatzgültigkeit geben Sie einen zukünftigen Zeitpunkt an, zu dem dieser Datensatz gelöscht werden soll. Weitere Details zur Planung von Datensatzgültigkeiten in der API finden Sie im Handbuch für Datensatzgültigkeits-Endpunkte.
Löschen von Datensätzen
Mit der Data Hygiene API können Sie alle mit einer Identität verknüpften Datensätze aus einem oder allen Datensätzen löschen. Alle Datenlebenszyklusaufgaben, die Identitäten löschen, werden durch ein Konstrukt dargestellt, das als Arbeitsreihenfolge bezeichnet wird. Siehe Endpunktleitfaden für Arbeitsaufträge für Details zum Arbeiten mit Datensatzlöschungen in der API.
Kontingent
Ihr Unternehmen ist auf ein vorab festgelegtes monatliches Auftragsquoten für jeden Datenlebenszyklusvorgang beschränkt, das je nach Lizenzierung variieren kann. Siehe Quotenendpunkt-Handbuch für Details zur Anzeige des aktuellen Quotenstatus Ihrer Datenlebenszyklusprozesse.
Nächste Schritte
In diesem Handbuch wurde beschrieben, wie Sie Datenlebenszyklusanfragen mithilfe von API-Aufrufen verwalten. Informationen zum Ausführen dieser Aktionen in der Platform-Benutzeroberfläche finden Sie in der Handbuch zur Benutzeroberfläche für die Datenlebenszyklusbenutzeroberfläche.