Datensatz in der API erstellen

So erstellen Sie einen Datensatz mit der Catalog API, Sie müssen die $id Wert der Experience Data Model (XDM)-Schema, auf dem der Datensatz basieren wird. Sobald Sie über die Schema-ID verfügen, können Sie einen Datensatz erstellen, indem Sie eine POST-Anfrage an die /datasets -Endpunkt im Catalog API.

NOTE
In diesem Dokument wird nur beschrieben, wie Sie ein Datensatzobjekt in Catalog. Ausführliche Anweisungen zum Erstellen, Füllen und Überwachen eines Datensatzes finden Sie im folgenden Tutorial.

API-Format

POST /dataSets

Anfrage

Die folgende Anfrage erstellt einen Datensatz, der auf ein zuvor definiertes Schema verweist.

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "name":"LoyaltyMembersDataset",
    "schemaRef": {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/719c4e19184402c27595e65b931a142b",
        "contentType": "application/vnd.adobe.xed+json;version=1"
    }
}'
Eigenschaft
Beschreibung
name
Der Name des zu erstellenden Datensatzes.
schemaRef.id
Der URI-$id-Wert für das XDM-Schema, auf dem der Datensatz basieren soll.
schemaRef.contentType
Gibt das Format und die Version des Schemas an. Weitere Informationen finden Sie im Abschnitt zur Schemaversionierung im XDM-API-Handbuch.
NOTE
In diesem Beispiel wird die Apache Parquet Dateiformat für containerFormat -Eigenschaft. Ein Beispiel zur Nutzung des JSON-Dateiformats finden Sie im Entwicklerhandbuch zur Batch-Erfassung.

Antwort

Eine erfolgreiche Antwort gibt den HTTP-Status 201 (Erstellt) und ein Antwortobjekt zurück, das aus einem Array mit der Kennung des neu erstellten Datensatzes im Format "@/datasets/{DATASET_ID}" besteht. Die Datensatz-ID ist eine schreibgeschützte, vom System generierte Zeichenfolge, mit der in API-Aufrufen auf den Datensatz verwiesen wird.

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676