מאפייני תגי עיצוב של MediaService (חובה)

בקטע הזה מופיעים הפרטים של מאפייני תגי התוכן של סוג הישות MediaService, שמתעדים את ההגדרות של השילוב של פעולת המדיה

נקודה חשובה: צריך למקם את הישות MediaService בתוך המערך dataFeedElement. לדוגמה: כאן

נקודה חשובה: כל שליחת פיד מדיה עם פעולות, חייבת לכלול ישות MediaService אחת ואחת בלבד לכל ספק של קישור עומק שמופיע בפיד.

טבלת מפרטים

מאפיין (property)	הסוג הנדרש	תיאור
@type	טקסט	חובה – תמיד מוגדר ל-MediaService.
@context	טקסט	חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}].
@id	כתובת URL	חובה – מזהה ייחודי של המותג. לדוגמה, https://example.com. המזהה חייב לעמוד בדרישות הבאות: הוא ייחודי בכל העולם בקטלוג שלך. הוא סטטי. המזהה צריך להיות יציב ולא להשתנות עם הזמן. הוא מופיע בפורמט של מזהה משאב מאוחד (URI). הדומיין חייב להיות בבעלות הארגון שלך.
name	טקסט	חובה – שם הספק. אם למותג שלך יש שמות ספציפיים ללוקאל, צריך לרשום אותם במערך. לדוגמה, אפשר לעיין בדוגמה של MediaService.
brandIcon	אובייקט תמונה	חובה לכל פעולות הצפייה ופעולות ההאזנה – קובץ התמונה של סמל המותג, חוזר על עצמו לכל גודל. בתוצאת הפעולה 'צפייה/האזנה', Google משייכת את קישורי העומק של התוכן שלך לסמל המותג. קובץ התמונה של סמל המותג חייב לעמוד בדרישות הבאות: זהו קובץ PNG. הרקע שלו שקוף. צורתו היא עגולה בטבעה. חשוב לוודא שהתמונות מונעות עיתוי או עיוות/מפוקסלות יש לחזור על המאפיין הזה כי עליך לספק חמש תמונות, אחת לכל אחד מהמאפיינים הבאים: 16x16 פיקסלים, עם קובץ בגודל של עד 1 KB 20x20 פיקסלים, עם קובץ בגודל של עד 1 KB 40x40 פיקסלים, עם קובץ בגודל של עד 1 KB 44x44 פיקסלים, עם קובץ בגודל של עד 1 KB 112x112 פיקסלים, עם קובץ בגודל של עד 3KB דרישות נוספות לשילובי Google TV – התמונות האלה של סמל המותג יוצגו בחלק העליון של מדריך התוכניות, בלחצני פעולת הצפייה ובהגדרות של Google TV. יש לספק שלושה סמלים שעומדים בדרישות הבאות: סמל מרובע אחד בפורמט קובץ PNG. (ברזולוציה של 512x512 פיקסלים, יחס גובה-רוחב של 1:1) סמל מילה לבן אחד בפורמט קובץ PNG. (הרזולוציה הגבוהה ביותר הזמינה, אין העדפה ליחס גובה-רוחב) סמל של מילה צבעונית אחת בפורמט קובץ PNG. (הרזולוציה הגבוהה ביותר הזמינה, אין העדפה ליחס גובה-רוחב) חשוב לוודא שהתמונות מונעות עיוות או טשטוש.
brandIcon.contentURL	כתובת URL	חובה – כתובת ה-URL של התמונה.
brandIcon.height	מספר	חובה – גובה התמונה, בפיקסלים.
brandIcon.width	מספר	חובה – רוחב התמונה, בפיקסלים.
brandIcon.additionalProperty	נכס Value	חובה – הנכס הנוסף שמשמש לתיאור סוג התמונה ומגדיר את השימושים המיועדים אליה.
brandIcon.additionalProperty.@type	טקסט	חובה – הגדרה כ-PropertyValue.
brandIcon.additionalProperty.name	טקסט	חובה – הגדרה כ-contentAttributes.
brandIcon.additionalProperty.value	טקסט	חובה – התאמה ברקע. כדי להיות תקין, יש להגדיר לפחות אחד מהערכים הבאים: forDarkBackground: תמונה, לרוב סמל שקוף, שמתאימה לשימוש על רקע כהה. forLightBackground: תמונה, בדרך כלל סמל שקוף, שמתאימה לשימוש על רקע בהיר.
application	SotappreApplication	חובה אם סופקו אפליקציות ל-iOS, Android, Cast או AndroidTV - רשימת אפליקציות המותג שלכם ברשימה הבאה: iOS Android העברה (cast) ב-AndroidTV
application.@type	טקסט	חובה – תמיד מוגדר ל-SoftwareApplication.
application.operatingSystem	טקסט	חובה – יש להגדיר אחת מהאפשרויות הבאות: iOS Android Cast AndroidTV
application.downloadUrl	כתובת URL	חובה אם רלוונטי – בפלטפורמות של Android, AndroidTV ו-iOS, צריך לציין את הקישור לאפליקציה ב-App Store ובחנות Play. בכל שאר הפלטפורמות, זהו לא נכס חובה.
application.installUrl	כתובת URL	אם רלוונטי – אם הספק מציע מדיה דרך אפליקציית Android TV, צריך לציין את הקישור בתור קישור לקובץ ה-APK של AndroidTV. אם הספק לא מציע הפעלה של AndroidTV, זה לא נכס חובה.
application.identifier	טקסט	חובה אם רלוונטי – לגבי פלטפורמות שתואמות לאחד מהערכים הבאים, מגדירים אותו בהתאם. נכס זה אינו נדרש מסיבה אחרת: iOS: מזהה האפליקציה ב-App Store. לדוגמה: 967093455. Android: שם החבילה של חנות Play ל-Android. לדוגמה: com.abc.media.android. העברה: מזהה אפליקציית ההעברה. לדוגמה: ACDA4FDE. AndroidTV: שם החבילה של חנות Play ל-AndroidTV. לדוגמה: com.abc.media.atv.android.
parentOrganization	ארגון	חובה – הספק הראשי של השירות.
parentOrganization.@type	טקסט	חובה – תמיד מוגדר ל-Organization.
parentOrganization.name	טקסט	חובה – שם הארגון.
subscriptions	MediaSubscription	אופציונלי – רשימת ה-MediaSubscriptions הזמינים שנתמכים על ידי ספק השעון.
baseSubscriptionTier	MediaSubscription	חובה אם אפשר – אם לספק הצפייה ולספק יש חבילת מינוי בסיסית, צריך להגדיר זאת במופע של המינוי לכל התוכן שזמין לכל המנויים. המאפיין הזה לא נדרש במקום אחר.
userRequestsFulfilledBy	טקסט	אופציונלי – מוגדר לגבי כל אחד מהצדדים שעונים על בקשות המשתמש: Google: כל הבקשות נענות על ידי Google. למעשה, Google מחזירה את קישור העומק של התוכן המבוקש. Provider: כל הבקשות מטופלות על ידי ספק התוכן – ספק Cloud. בעיקרון, הספק מחזיר את קישור העומק עבור התוכן המבוקש, או יוזם את ההפעלה ישירות במכשירים שלו. כברירת מחדל, הנכס הזה מוגדר לערך Google.
mediaOffered	טקסט	חובה – מוגדר לאחת מהאפשרויות הבאות, בהתאם לסוגי התוכן בקטלוג שכלולים בפיד: ["VoD"] – הספק כולל בפיד רק תוכן וידאו על פי דרישה (VoD). תוכן ה-VOD כולל סרטים ותוכניות טלוויזיה. ["LiveTV"] – הספק כולל רק בפיד את הטלוויזיה בשידור חי, שכוללת את התוכן ערוצים ו-BroadcastEvent. ["VoD", "LiveTV"] – הספק כולל בפיד את התוכן של VoD וגם של טלוויזיה בשידור חי. ["Music"] – הספק כולל בפיד רק ישויות מוזיקה. התוכן כולל אלבומים, אומנים, שירים ופלייליסטים. ["Radio"] – הספק כולל בפיד רק ישויות של רדיו. ["Music", "Radio"] – הספק כולל בפיד יישויות מוזיקה ורדיו. התוכן כולל אלבומים, אומנים, שירים, פלייליסטים, ותחנות רדיו. הערה: כלי האימות מתבססים על הפרטים האלה כדי להחיל את שלבי האימות המתאימים.

דוגמה ל-MediaService

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": [
        "http://schema.org",
        {
          "@language": "en"
        }
      ],
      "@type": "MediaService",
      "@id": "https://abcmedia.com",
      "name": [
        {
          "@language": "en-us",
          "@value": "ABC Media"
        },
        {
          "@language": "en-gb",
          "@value": "ABC"
        }
      ],
      "userRequestsFulfilledBy": "Google",
      "mediaOffered": [
        "LiveTV",
        "VoD"
      ],
      "brandIcon": [
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
          "width": 16,
          "height": 16,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
          "width": 20,
          "height": 20,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
          "width": 40,
          "height": 40,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
          "width": 44,
          "height": 44,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
          "width": 112,
          "height": 112,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        }
      ],
      "application": [
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Android",
          "downloadUrl": "https://google.play.store/com.abc.media.android",
          "identifier": "com.abc.media.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "iOS",
          "downloadUrl": "https://apple.app.store/967093455",
          "identifier": "967093455"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "AndroidTV",
          "downloadUrl": "https://google.play.store/com.abc.media.atv.android",
          "installUrl": "https://abcmedia.com/path_to_apkfile.apk",
          "identifier": "com.abc.media.atv.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Cast",
          "identifier": "ACDA4FDE"
        }
      ],
      "subscriptions": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:basic"
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:premium"
        }
      ],
      "baseSubscriptionTier": {
        "@type": "MediaSubscription",
        "name": "Basic Package",
        "@id": "[partner determined string]",
        "identifier": "abcmedia.com:basic"
      },
      "parentOrganization": {
        "@type": "Organization",
        "name": "ABC Media"
      }
    }
  ]
}