API에서 데이터 세트 만들기
Catalog API를 사용하여 데이터 집합을 만들려면 데이터 집합의 기반이 되는 Experience Data Model (XDM) 스키마의 $id 값을 알고 있어야 합니다. 스키마 ID가 있으면 Catalog API의 /datasets 끝점에 POST 요청을 하여 데이터 세트를 만들 수 있습니다.
노트
이 문서에서는 Catalog에서 데이터 집합 개체를 만드는 방법에만 다룹니다. 데이터 세트를 생성, 채우기 및 모니터링하는 방법에 대한 전체 단계는 다음 자습서를 참조하십시오.
API 형식
POST /dataSets
요청
다음 요청은 이전에 정의된 스키마를 참조하는 데이터 세트를 만듭니다.
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: {IMS_ORG}' \
-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"
}
}'
| 속성 | 설명 |
|---|---|
name |
만들 데이터 세트의 이름입니다. |
schemaRef.id |
데이터 세트에 기반이 되는 XDM 스키마의 URI $id 값입니다. |
schemaRef.contentType |
스키마의 형식 및 버전을 나타냅니다. 자세한 내용은 XDM API 안내서의 스키마 버전 관리에 대한 섹션을 참조하십시오. |
노트
이 예제에서는 containerFormat 속성에 대해 Apache Parided 파일 형식을 사용합니다. JSON 파일 형식을 사용하는 예제는 일괄 처리 통합 개발자 가이드에서 찾을 수 있습니다.
응답
성공적인 응답은 HTTP 상태 201(만들어짐)과 새로 만든 데이터 세트의 ID를 "@/datasets/{DATASET_ID}" 형식으로 포함하는 배열로 구성된 응답 개체를 반환합니다. 데이터 세트 ID는 API 호출에서 데이터 세트를 참조하는 데 사용되는 읽기 전용 시스템 생성 문자열입니다.
[
"@/dataSets/5c8c3c555033b814b69f947f"
]
지역 변경
