Handbuch zur Data Access API
Die Data Access API unterstützt Adobe Experience Platform, indem sie Benutzern eine RESTful-Schnittstelle bereitstellt, die sich auf die Auffindbarkeit und Zugänglichkeit erfasster Datensätze innerhalb von Experience Platform konzentriert.
API-Spezifikationsreferenz
In der Dokumentation zu Data Access OpenAPI finden Sie ein standardisiertes, maschinenlesbares Format für einfachere Integration, Tests und Exploration.
Terminologie terminology
Die Tabelle enthält eine Beschreibung einiger Begriffe, die in diesem Dokument häufig verwendet werden.
Liste der Dateien in einem Batch abrufen retrieve-list-of-files-in-a-batch
Um eine Liste von Dateien abzurufen, die zu einem bestimmten Batch gehören, verwenden Sie die Batch-Kennung (batchID) mit der Data Access API.
API-Format
GET /batches/{BATCH_ID}/files
{BATCH_ID}
Anfrage
curl -X GET https://platform.adobe.io/data/foundation/export/batches/{BATCH_ID}/files \
-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
{
"data": [
{
"dataSetFileId": "{FILE_ID_1}",
"dataSetViewId": "string",
"version": "1.0.0",
"created": "string",
"updated": "string",
"isValid": true,
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID_1}"
}
}
},
{
"dataSetFileId": "{FILE_ID_2}",
"dataSetViewId": "string",
"version": "1.0.0",
"created": "string",
"updated": "string",
"isValid": true,
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID_2}"
}
}
},
],
"_page": {
"limit": 100,
"count": 1
}
}
Das Array "data"
enthält eine Liste aller Dateien innerhalb des angegebenen Batches. Jede zurückgegebene Datei verfügt über eine eigene eindeutige ID ({FILE_ID}
), die im Feld "dataSetFileId"
enthalten ist. Sie können diese eindeutige ID verwenden, um auf die Datei zuzugreifen oder sie herunterzuladen.
data.dataSetFileId
data._links.self.href
Zugreifen auf und Herunterladen von Dateien in einem Batch
Um auf bestimmte Details einer Datei zuzugreifen, verwenden Sie eine Dateikennung ({FILE_ID}
) mit der Data Access API, einschließlich des Namens, der Größe in Byte und eines Links zum Herunterladen.
Die Antwort enthält ein Daten-Array. Je nachdem, ob es sich bei der von der ID referenzierten Datei um eine einzelne Datei oder ein Verzeichnis handelt, kann das zurückgegebene Datenarray einen einzelnen Eintrag oder eine Liste von Dateien enthalten, die zu diesem Verzeichnis gehören. Jedes Dateielement enthält die Details der Datei.
API-Format
GET /files/{FILE_ID}
{FILE_ID}
"dataSetFileId"
", der Kennung der Datei, auf die zugegriffen werden soll.Anfrage
curl -X GET https://platform.adobe.io/data/foundation/export/files/{FILE_ID} \
-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}'
Einzelne Dateiantwort
{
"data": [
{
"name": "{FILE_NAME}",
"length": "{LENGTH}",
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID}?path={FILE_NAME}"
}
}
}
],
"_page": {
"limit": 100,
"count": 1
}
}
data.name
profiles.csv
).data.length
data._links.self.href
Ordnerantwort
{
"data": [
{
"dataSetFileId": "{FILE_ID_1}",
"dataSetViewId": "string",
"version": "1.0.0",
"created": "string",
"updated": "string",
"isValid": true,
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID_1}"
}
}
},
{
"dataSetFileId": "{FILE_ID_2}",
"dataSetViewId": "string",
"version": "1.0.0",
"created": "string",
"updated": "string",
"isValid": true,
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID_2}"
}
}
}
],
"_page": {
"limit": 100,
"count": 2
}
}
Wenn ein Verzeichnis zurückgegeben wird, enthält es ein Array aller Dateien im Ordner.
data.name
profiles.csv
).data._links.self.href
Dateiinhalt aufrufen access-file-contents
Sie können auch die Data Access -API verwenden, um auf den Inhalt einer Datei zuzugreifen. Sie können die Inhalte dann in eine externe Quelle herunterladen.
API-Format
GET /files/{dataSetFileId}?path={FILE_NAME}
{FILE_NAME}
Anfrage
curl -X GET https://platform.adobe.io/data/foundation/export/files/{FILE_ID}?path={FILE_NAME} \
-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}'
{FILE_ID}
{FILE_NAME}
profiles.csv
).Antwort
Contents of the file
Zusätzliche Codebeispiele
Weitere Beispiele finden Sie im Tutorial Datenzugriff.
Abonnieren von Datenerfassungsereignissen subscribe-to-data-ingestion-events
Sie können bestimmte Ereignisse mit hohem Wert über die Adobe Developer Console abonnieren. Sie können beispielsweise Ereignisse zur Datenaufnahme abonnieren, um über potenzielle Verzögerungen und Fehler informiert zu werden. Weitere Informationen finden Sie im Tutorial zum Anmelden von Adobe-Ereignisbenachrichtigungen 🔗.