동작 끝점

XDM(Experience Data Model)에서 동작은 스키마에서 설명하는 데이터의 특성을 정의합니다. 각 XDM 클래스는 특정 동작을 참조해야 하며 이 동작은 해당 클래스를 사용하는 모든 스키마에서 상속됩니다. Platform의 거의 모든 사용 사례에 대해 사용 가능한 동작은 두 가지가 있습니다.

  • 레코드:주체의 특성에 대한 정보를 제공합니다. 주제는 조직 또는 개인일 수 있습니다.
  • 시계열:작업 수행 시 레코드 주체가 직접 또는 간접적으로 시스템의 스냅샷을 제공합니다.
노트

Platform에는 위의 동작 중 하나를 사용하지 않는 스키마를 사용해야 하는 사용 사례가 있습니다. 이러한 경우 세 번째 "ad-hoc" 동작을 사용할 수 있습니다. 자세한 내용은 임시 스키마 만들기의 자습서를 참조하십시오.

데이터 동작이 스키마 구성에 미치는 영향에 대한 일반적인 자세한 내용은 스키마 구성🔗의 기본 사항에 대한 안내서를 참조하십시오.

Schema Registry API의 /behaviors 종단점을 사용하면 global 컨테이너에서 사용 가능한 동작을 볼 수 있습니다.

시작하기

이 안내서에 사용된 엔드포인트는 Schema Registry API의 일부입니다. 계속하기 전에 시작 안내서에서 관련 설명서에 대한 링크, 이 문서에서 샘플 API 호출을 읽는 방법에 대한 안내서, 모든 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요한 정보를 검토하십시오.

동작 목록 검색

/behaviors 종단점에 GET 요청을 수행하여 사용 가능한 모든 동작 목록을 검색할 수 있습니다.

API 형식

GET /global/behaviors

요청

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/global/behaviors \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed-id+json'

응답

{
    "results": [
        {
            "$id": "https://ns.adobe.com/xdm/data/record",
            "meta:altId": "_xdm.data.record",
            "version": "1.16.4",
            "title": "Record Schema"
        },
        {
            "$id": "https://ns.adobe.com/xdm/data/adhoc",
            "meta:altId": "_xdm.data.adhoc",
            "version": "1.16.4",
            "title": "Ad Hoc Schema"
        },
        {
            "$id": "https://ns.adobe.com/xdm/data/time-series",
            "meta:altId": "_xdm.data.time-series",
            "version": "1.16.4",
            "title": "Time-series Schema"
        }
    ],
    "_page": {
        "orderby": "updated",
        "next": null,
        "count": 3
    },
    "_links": {
        "next": null
    }
}

동작 검색

/behaviors 종단점에 GET 요청 경로에 해당 ID를 제공하여 특정 동작을 확인할 수 있습니다.

API 형식

GET /global/behaviors/{BEHAVIOR_ID}
매개 변수 설명
{BEHAVIOR_ID} 조회하려는 동작의 meta:altId 또는 URL로 인코딩된 $id

요청

다음 요청은 요청 경로에 meta:altId을 제공하여 레코드 동작의 세부 사항을 검색합니다.

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/global/behaviors/_xdm.data.record \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed+json;version=1'

응답

성공한 응답은 해당 버전, 설명 및 해당 동작이 사용하는 클래스에 제공하는 속성을 비롯하여 동작의 세부 정보를 반환합니다.

{
    "$id": "https://ns.adobe.com/xdm/data/record",
    "meta:altId": "_xdm.data.record",
    "meta:resourceType": "behaviors",
    "version": "1.16.4",
    "title": "Record Schema",
    "type": "object",
    "description": "Used to indicate the behavior of record data semantic when composed into data schemas.",
    "definitions": {
        "record": {
            "properties": {
                "_id": {
                    "title": "Identifier",
                    "type": "string",
                    "format": "uri-reference",
                    "description": "A unique identifier for the record.",
                    "meta:xdmType": "string",
                    "meta:xdmField": "@id"
                }
            }
        }
    },
    "allOf": [
        {
            "$ref": "#/definitions/record",
            "type": "object",
            "meta:xdmType": "object"
        },
        {
            "$ref": "https://ns.adobe.com/xdm/common/extensible#/definitions/@context",
            "type": "object",
            "meta:xdmType": "object"
        }
    ],
    "meta:extensible": true,
    "meta:abstract": true,
    "meta:xdmType": "object",
    "meta:status": "stable",
    "$schema": "http://json-schema.org/draft-06/schema#",
    "meta:registryMetadata": {
        "repo:createdDate": 1606266789446,
        "repo:lastModifiedDate": 1606266789446,
        "eTag": "2cc114a54949a9668fe2ad046ccece59192e1bfa28f14e5ac7c893acb7820ba2",
        "meta:globalLibVersion": "1.16.4"
    }
}

다음 단계

이 안내서에서는 Schema Registry API에서 /behaviors 종단점의 사용에 대해 다룹니다. API를 사용하여 클래스에 동작을 할당하는 방법에 대한 자세한 내용은 클래스 엔드포인트 가이드를 참조하십시오.

이 페이지에서는