Để xác thực các thực thể khi bạn tạo hoặc cập nhật nguồn cấp dữ liệu, hãy sử dụng các Giản đồ JSON sau. Các giản đồ này dựa trên thông số kỹ thuật của Giản đồ JSON. Bằng cách thêm một bài kiểm thử đơn vị để xác thực các thực thể mà bạn tạo, bạn có thể phát hiện các vấn đề sẽ ảnh hưởng đến chất lượng nguồn cấp dữ liệu. Bạn cũng có thể sử dụng các giản đồ này trong quá trình phát triển nguồn cấp dữ liệu để tránh các lỗi thường gặp.
Chọn giản đồ Hành động trên nội dung nghe nhìn
- Giản đồ video theo yêu cầu xác thực các thực thể
Movie
,TVEpisode
,TVSeries
vàTVSeason
. - Giản đồ truyền hình trực tiếp xác thực các thực thể
BroadcastEvent
,BroadcastService
,CableOrSatelliteService
,Movie
,Organization
,SportsEvent
,TelevisionChannel
,TVEpisode
,TVSeason
vàTVSeries
. - Music Schema xác thực các thực thể
MusicAlbum
,MusicGroup
,MusicPlaylist
vàMusicRecording
. - Radio Schema xác thực các thực thể
RadioBroadcastService
.
Hãy sử dụng thông số kỹ thuật trên trang web này làm nguồn đáng tin cậy, vì các giản đồ này có thể chưa triển khai hết tất cả các tính năng.
Chọn trình xác thực
Bạn có thể tìm thấy danh sách cách triển khai trình xác thực trên json-schema.org.
Các giản đồ được cung cấp được viết bằng bản nháp 7, vì vậy, phương thức triển khai mà bạn chọn cần hỗ trợ phiên bản này để hoạt động đúng cách.
Ví dụ về quy trình xác thực
Ví dụ sau đây cho biết cách xác thực tất cả các thực thể có trong tệp feed.json
bằng cách sử dụng tệp giản đồ schema.json
và mô-đun python jsonschema. Các thực thể này nằm trong thuộc tính dataFeedElement
như được chỉ định trong tài liệu về thư bao nguồn cấp dữ liệu.
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")