피드를 만들거나 업데이트할 때 항목을 검증하려면 다음 JSON 스키마를 사용하세요. 스키마는 JSON 스키마 사양을 기반으로 합니다. 생성한 항목의 유효성을 검사하는 단위 테스트를 추가하면 피드 품질에 영향을 미치는 문제를 감지할 수 있습니다. 피드 개발 중에 이러한 스키마를 사용하여 일반적인 오류를 방지할 수도 있습니다.
미디어 작업 스키마 선택
- VOD 스키마는
Movie
,TVEpisode
,TVSeries
,TVSeason
항목을 검증합니다. - 라이브 TV 스키마는
BroadcastEvent
,BroadcastService
,CableOrSatelliteService
,Movie
,Organization
,SportsEvent
,TelevisionChannel
,TVEpisode
,TVSeason
,TVSeries
항목을 검증합니다. - 음악 스키마는
MusicAlbum
,MusicGroup
,MusicPlaylist
,MusicRecording
항목을 검증합니다. - 라디오 스키마는
RadioBroadcastService
항목을 검증합니다.
이러한 스키마에 모든 기능이 구현되어 있지 않을 수 있으므로 이 사이트의 사양을 정보 소스로 사용하세요.
검사기 선택
json-schema.org에서 검사기 구현 목록을 확인할 수 있습니다.
제공된 스키마는 초안 7으로 작성되었으므로 선택한 구현이 이 버전을 지원해야 제대로 작동합니다.
유효성 검사의 예
다음 예에서는 스키마 파일 schema.json
및 jsonschema Python 모듈을 사용하여 feed.json
파일에 있는 모든 항목을 검증하는 방법을 보여줍니다. 항목은 데이터 피드 엔벨로프 문서에 지정된 대로 dataFeedElement
속성에 있습니다.
import json
from jsonschema import validate
# Loading the schema file
with open("schema.json", "r") as fp:
schema = json.load(fp)
# Opening the feed
with open("feed.json", "r") as fp:
feed = json.load(fp)
# Validating each entity in the feed
for entity in feed["dataFeedElement"] :
try:
validate(schema=schema, instance=entity)
print("Entity validated successfully")
except Exception as e:
# e may contain an explanation as to why the entity wasn't valid
print("Failed to validate the entity")