Dieses Entwicklerhandbuch enthält Schritte zum Ausführen verschiedener Vorgänge in der Query Service-API von Adobe Experience Platform.
Dieses Handbuch setzt Grundkenntnisse der verschiedenen Adobe Experience Platform-Services voraus, die mit der Verwendung von Query Service zusammenhängen.
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um Query Service mithilfe der API erfolgreich zu verwenden zu können.
In diesem Handbuch 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 dieser Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Fehlerbehebungshandbuch für Experience Platform.
Um Experience 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 Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:
Bearer {ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
Alle Ressourcen in Experience Platform sind auf bestimmte virtuelle Sandboxes beschränkt. Alle an Platform-APIs gerichtete Anfragen müssen über eine Kopfzeile verfügen, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt wird:
{SANDBOX_NAME}
Weitere Informationen zum Arbeiten mit Sandboxes in Experience Platform finden Sie in der Sandbox-Übersichtsdokumentation.
Nachdem Sie nun wissen, welche Kopfzeilen zu verwenden sind, können Sie damit beginnen, die Query Service-API aufzurufen. In den folgenden Dokumenten werden die verschiedenen API-Aufrufe beschrieben, die Sie mithilfe der Query Service-API ausführen können. Jeder Beispielaufruf enthält das allgemeine API-Format, eine Beispielanfrage mit den erforderlichen Kopfzeilen und eine Beispielantwort.
Nachdem Sie nun gelernt haben, wie Sie Aufrufe mit der Query Service-API formulieren, können Sie Ihre eigenen nicht interaktiven Abfragen erstellen. Weitere Informationen zum Erstellen von Abfragen finden Sie im SQL-Referenzhandbuch.