موجودیت ها را با طرحواره های 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 و ماژول پایتون 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")