DocumentatieExperience PlatformHandleiding voor catalogi en gegevenssets

Een gegevensset maken in de API

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar

Als u een gegevensset wilt maken met de Catalog API, moet u de $id -waarde weten van het Experience Data Model -schema (XDM) waarop de gegevensset wordt gebaseerd. Als u de schema-id hebt, kunt u een gegevensset maken door een aanvraag voor een POST in te dienen bij het eindpunt /datasets in de Catalog API.

NOTE
In dit document wordt alleen beschreven hoe u een gegevenssetobject maakt in Catalog . Voor volledige stappen op om, een dataset tot stand te brengen te bevolken en te controleren, gelieve te verwijzen naar het volgende ​ leerprogramma ​.

API formaat

POST /dataSets

Verzoek

Het volgende verzoek leidt tot een dataset die verwijzingen een eerder bepaald schema.

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"
    }
}'
Eigenschap
Beschrijving
name
De naam van de gegevensset die moet worden gemaakt.
schemaRef.id
De URI $id-waarde voor het XDM-schema waarop de gegevensset wordt gebaseerd.
schemaRef.contentType
Geeft de indeling en versie van het schema aan. Zie de sectie over ​ schema versioning ​ in de gids XDM API voor meer informatie.
NOTE
Dit voorbeeld gebruikt het 🔗 dossierformaat van de Parket van 0} Apache {voor zijn containerFormat bezit. Een voorbeeld dat het JSON dossierformaat gebruikt kan in de ​ handleiding van de partijontwikkelaar ​ worden gevonden.

Reactie

Een geslaagde reactie retourneert HTTP Status 201 (Gemaakt) en een reactieobject dat bestaat uit een array met de id van de nieuwe dataset in de indeling "@/datasets/{DATASET_ID}" . De dataset ID is een read-only, systeem-geproduceerde koord dat wordt gebruikt om de dataset in API vraag van verwijzingen te voorzien.

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