DocumentatieExperience PlatformHandleiding voor catalogi en gegevenssets

Een gegevensset maken in de API

Last update: Tue Jul 16 2024 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 versioningin 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 partijontwikkelaarworden 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