Policy Service API 시작하기

Policy Service API를 사용하여 Adobe Experience Platform Data Governance과 관련된 다양한 리소스를 만들고 관리할 수 있습니다. 이 문서에서는 Policy Service API를 호출하기 전에 알아야 하는 핵심 개념을 소개합니다.

전제 조건

개발자 안내서를 사용하려면 데이터 거버넌스 기능 작업과 관련된 다양한 Experience Platform 서비스에 대한 충분한 지식이 있어야 합니다. Policy Service API에서 작업하기 전에 다음 서비스에 대한 설명서를 검토하십시오.

• Data Governance:데이터 Experience Platform 사용 규정 준수를 적용하는 프레임워크
• Experience Data Model (XDM) System:고객 경험 데이터를 Experience Platform 구성하는 표준화된 프레임워크
• Real-time Customer Profile:여러 소스에서 집계된 데이터를 기반으로 통합된 실시간 소비자 프로필을 제공합니다.
• 샌드박스: Experience Platform 디지털 경험 애플리케이션을 개발 및 발전시키는 데 도움이 되도록 단일 Platform 인스턴스를 별도의 가상 환경으로 분할하는 가상 샌드박스를 제공합니다.

샘플 API 호출 읽기

Policy Service API 설명서는 요청의 서식을 지정하는 방법을 보여주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 올바른 형식의 요청 페이로드가 포함됩니다. API 응답으로 반환된 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용된 규칙에 대한 자세한 내용은 Experience Platform 문제 해결 안내서의 API 호출 예를 읽는 방법에 대한 섹션을 참조하십시오.

필수 헤더

또한 API 설명서는 Platform 끝점을 성공적으로 호출하려면 인증 자습서를 완료해야 합니다. 인증 자습서를 완료하면 아래와 같이 Experience Platform API 호출에서 각 필수 헤더에 대한 값을 제공합니다.

• Authorization: Bearer {ACCESS_TOKEN}
• x-api-key: {API_KEY}
• x-gw-ims-org-id: {IMS_ORG}

Data Governance에 속하는 리소스를 포함하여 Experience Platform의 모든 리소스는 특정 가상 샌드박스로 구분됩니다. Platform API에 대한 모든 요청에는 작업이 수행할 샌드박스의 이름을 지정하는 헤더가 필요합니다.

• x-sandbox-name: {SANDBOX_NAME}

페이로드(POST, PUT, PATCH)을 포함하는 모든 요청에는 추가 헤더가 필요합니다.

• Content-Type: application/json

핵심 리소스와 사용자 지정 리소스 비교

Policy Service API 내에서 모든 정책 및 마케팅 작업을 core 또는 custom 리소스로 참조합니다.

core 리소스는 Adobe에서 정의 및 유지 관리하는 custom 리소스인 반면, 리소스는 조직에서 만들고 유지 관리하는 리소스로, 따라서 IMS 조직에서만 고유하고 표시됩니다. 이와 같이 목록 및 조회 작업(GET)은 core 리소스에서 허용된 유일한 작업이지만 목록, 조회 및 업데이트 작업(POST, PUT, PATCH 및 DELETE)은 custom 리소스에 사용할 수 있습니다.

다음 단계

정책 서비스 API를 사용하여 호출을 시작하려면 사용 가능한 끝점 가이드 중 하나를 선택합니다.