التحقّق من صحة الكيانات باستخدام مخططات JSON

للتحقّق من صحة الكيانات عند إنشاء خلاصتك أو تعديلها، استخدِم مخطّطات JSON التالية. تستند المخططات إلى مواصفات مخطّط JSON. من خلال إضافة اختبار وحدة للتحقّق من صحة الكيانات التي تنشئها، يمكنك رصد المشاكل التي قد تؤثّر في جودة الخلاصة. يمكنك أيضًا استخدام هذه المخططات أثناء تطوير خلاصتك لتجنّب الأخطاء الشائعة.

اختيار مخطّط "إجراءات الوسائط"

• يتحقق مخطّط الفيديوهات عند الطلب من صحة عناصر Movie وTVEpisode وTVSeries وTVSeason.
• يتحقق مخطّط التلفزيون المباشر من صحة العناصر BroadcastEvent وBroadcastService وCableOrSatelliteService وMovie وOrganization وSportsEvent وTelevisionChannel وTVEpisode وTVSeason وTVSeries.
• يُجري Music Schema عمليات تحقّق من عناصر 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")