للتحقّق من صحة الكيانات أثناء إنشاء خلاصتك أو تعديلها، استخدِم ملف JSON التالي المخططات. تستند المخططات إلى مواصفات مخطط JSON. عن طريق إضافة اختبار وحدة للتحقق من صحة الكيانات التي تنشئها، يمكنك اكتشاف قد تؤثر في جودة الخلاصة يمكنك أيضًا استخدام هذه المخططات أثناء تطوير خلاصتك لتجنُّب الأخطاء الشائعة.
اختيار مخطط لمهام الوسائط
- يتحقّق مخطط الفيديو عند الطلب من صحة الكيانات
MovieوTVEpisodeوTVSeriesوTVSeason. - يتحقّق مخطط البث التلفزيوني المباشر من صحة الكيانات
BroadcastEventوBroadcastServiceوCableOrSatelliteServiceوMovieوOrganizationوSportsEventوTelevisionChannelوTVEpisodeوTVSeasonوTVSeries. - يتحقّق مخطط الموسيقى من صحة الكيانات
MusicAlbumوMusicGroupوMusicPlaylistوMusicRecording. - يتحقّق المخطط الراديو من صحة كيانات
RadioBroadcastService.
استخدِم المواصفات على هذا الموقع الإلكتروني باعتبارها مصدرًا للحقيقة، حيث قد لا يتم تنفيذ جميع الميزات في هذه المخططات.
اختيار مدقّق
يمكنك العثور على قائمة بعمليات تنفيذ أداة التحقّق من الصحة على json-schema.org.
المخططات المقدّمة مكتوبة في المسودة 7، وبالتالي يجب أن يتوافق التنفيذ الذي تختاره مع هذا الإصدار ليعمل بشكل سليم.
مثال على عملية التحقّق
يوضّح المثال التالي كيفية التحقّق من صحة جميع الكيانات المتوفّرة في ملف.
feed.json باستخدام ملف المخطط schema.json ووحدة python jsonschema. تقع الكيانات في
السمة 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")