מאפייני סימון תוכן של MediaService (חובה)

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

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

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

טבלת מפרט

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