비헤이비어 끝점

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

  • 레코드: 제목의 특성에 대한 정보를 제공합니다. 주제는 조직 또는 개인일 수 있습니다.
  • 시계열: 레코드 주체가 직접 또는 간접적으로 작업을 수행한 시간에 시스템의 스냅숏을 제공합니다.
NOTE
위의 동작 중 하나를 사용하지 않는 스키마를 사용해야 하는 Platform의 일부 사용 사례가 있습니다. 이러한 경우 세 번째 "임시" 동작을 사용할 수 있습니다. 자세한 내용은 임시 스키마 만들기에 대한 자습서를 참조하십시오.
스키마 구성에 영향을 미치는 방식에 따른 데이터 동작에 대한 일반적인 내용은 스키마 구성 기본 사항에 대한 안내서를 참조하십시오.

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

시작하기

이 가이드에 사용된 끝점은 Schema Registry API의 일부입니다. 계속하기 전에 시작 안내서를 검토하여 관련 문서에 대한 링크, 이 문서의 샘플 API 호출 읽기 지침 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보를 확인하십시오.

비헤이비어 목록 검색 list

/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: {ORG_ID}' \
  -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
    }
}

동작 조회 lookup

/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: {ORG_ID}' \
  -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를 사용하여 클래스에 동작을 할당하는 방법에 대한 자세한 내용은 클래스 끝점 안내서를 참조하십시오.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07