Để 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 tệp JSON sau Giản đồ. Giản đồ này dựa trên quy cách 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 đối tượng mà bạn tạo, bạn có thể phát hiện các vấn đề có thể ảnh hưởng đến chất lượng nguồn cấp dữ liệu. Bạn cũng có thể dùng những giản đồ này trong khoảng thời gian 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 một giản đồ Hành động đối với nội dung đa phương tiệ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 tuyến xác thực các thực thể
BroadcastEvent
,BroadcastService
,CableOrSatelliteService
,Movie
,Organization
,SportsEvent
,TelevisionChannel
,TVEpisode
,TVSeason
vàTVSeries
. - Giản đồ âm nhạc xác thực các thực thể
MusicAlbum
,MusicGroup
,MusicPlaylist
vàMusicRecording
. - Giản đồ vô tuyến 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ì những giản đồ này có thể không triển khai được tất cả tính năng.
Chọn trình xác thực
Bạn có thể xem danh sách các phương pháp 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 trong bản nháp 7, vì vậy, cách triển khai bạn chọn cần hỗ trợ phiên bản này để hoạt động đúng cách.
Ví dụ về cách xác thực
Ví dụ sau đây trình bày cách xác thực tất cả các thực thể có trong một 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 phong bì 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")