비헤이비어 끝점

XDM(경험 데이터 모델)에서 비헤이비어는 스키마에서 설명하는 데이터의 특성을 정의합니다. 각 XDM 클래스는 특정 비헤이비어를 참조해야 하며, 이 클래스를 사용하는 모든 스키마는 상속됩니다. Platform(플랫폼)에서 거의 모든 사용 사례에는 두 가지 사용 가능한 비헤이비어가 있습니다.

  • Record:제목 속성에 대한 정보를 제공합니다. 대상은 조직 또는 개인일 수 있습니다.
  • Time-series:작업 수행 시 기록 제목에 의해 직접 또는 간접적으로 작업이 수행될 때 시스템의 스냅샷을 제공합니다.
노트

플랫폼에서 위의 비헤이비어 중 하나를 사용하지 않는 스키마를 사용해야 하는 경우도 있습니다. 이러한 경우 세 번째 "임시" 동작을 사용할 수 있습니다. 자세한 내용은 애드혹 스키마 만들기의 자습서를 참조하십시오.

데이터 비헤이비어가 스키마 구성에 영향을 주는 방식에 대한 자세한 일반 정보는 스키마 컴포지션🔗의 기본 사항에 대한 안내서를 참조하십시오.

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를 사용하여 클래스에 비헤이비어를 할당하는 방법을 알아보려면 클래스 끝점 안내서를 참조하십시오.

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now