Show Menu
THEMEN×

Getting started with the Policy Service API

Mit der Policy Service API können Sie verschiedene Ressourcen im Zusammenhang mit Adobe Experience Platform erstellen und verwalten Data Governance. This document provides an introduction to the core concepts you need to know before attempting to make calls to the Policy Service API.

Voraussetzungen

Die Verwendung des Entwicklerhandbuchs erfordert ein grundlegendes Verständnis der verschiedenen Experience Platform Dienste, die beim Arbeiten mit Data Governance-Funktionen erforderlich sind. Before beginning to work with the Policy Service API, please review the documentation for the following services:
  • -Datenverwaltung : Das Framework, mit dem die Einhaltung der Datenverwendung Experience Platform erzwungen wird.
  • Experience Data Model (XDM) System : Das standardisierte Framework, mit dem Kundenerlebnisdaten Experience Platform organisiert werden.
  • Echtzeit-Profil : Bietet ein einheitliches, Echtzeit-Profil für Kunden, das auf aggregierten Daten aus mehreren Quellen basiert.
  • Sandboxen : Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform Instanz in separate virtuelle Umgebung unterteilen, um Anwendungen für digitale Erlebnisse zu entwickeln und weiterzuentwickeln.

Lesen von Beispiel-API-Aufrufen

The Policy Service API documentation provides example API calls to demonstrate how to format your requests. 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

Erforderliche Kopfzeilen

The API documentation also requires you to have completed the authentication tutorial in order to successfully make calls to Platform endpoints. Completing the authentication tutorial provides the values for each of the required headers in Experience Platform API calls, as shown below:
  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
All resources in Experience Platform, including those belonging to Data Governance, are isolated to specific virtual sandboxes. All requests to Platform APIs require a header that specifies the name of the sandbox the operation will take place in:
  • x-sandbox-name: {SANDBOX_NAME}
For more information on sandboxes in Platform, see the sandbox overview documentation .
Bei allen Anfragen mit einer Payload (POST, PUT, PATCH) ist eine zusätzliche Kopfzeile erforderlich:
  • Content-Type: application/json

Kernressourcen und benutzerdefinierte Ressourcen

Within the Policy Service API, all policies and marketing actions are referred to as either core or custom resources.
core Ressourcen sind die von der Adobe definierten und verwalteten Ressourcen, während custom Ressourcen von Ihrer Organisation erstellt und verwaltet werden und daher einmalig und nur für Ihre IMS-Organisation sichtbar sind. Darum sind Auflistungs- und Nachschlagevorgänge ( GET ) die einzigen Vorgänge, die bei core -Ressourcen zulässig sind, während bei custom -Ressourcen Auflistungs-, Nachschlage- und Aktualisierungsvorgänge ( POST , PUT , PATCH und DELETE ) verfügbar sind.

Nächste Schritte

Um mit dem Aufrufen der Policy Service API zu beginnen, wählen Sie eine der verfügbaren Endpunktleitfäden aus.