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

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

טבלת מפרט

מאפיין (property) הסוג הנדרש תיאור
@type טקסט

חובה – תמיד מוגדר ל-MediaService.

@context טקסט

חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}].

@id כתובת URL

חובה – מזהה ייחודי למותג שלכם. לדוגמה, https://example.com.

המזהה חייב לעמוד בדרישות הבאות:

  • הוא ייחודי בכל העולם בקטלוג שלך.
  • הוא סטטי. המזהה צריך להיות יציב ולא להשתנות לאורך זמן.
  • הוא בפורמט של מזהה משאב מאוחד (URI).
  • הדומיין שלו חייב להיות בבעלות הארגון שלך.
name טקסט

חובה – שם הספק.

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

brandIcon אובייקט תמונה

חובה לכל פעולות הצפייה ופעולות ההאזנה – קובץ התמונה של סמל המותג, חוזר על עצמו, בכל גודל. בתוצאת הפעולה 'צפייה/האזנה', Google משייכת את קישורי העומק של התוכן שלך לסמל המותג.

קובץ התמונה של סמל המותג צריך לעמוד בדרישות הבאות:

  • זהו קובץ PNG.
  • הרקע שלו שקוף.
  • צורתו היא עגולה בטבע.
  • מוודאים שהתמונות נטושות ללא עיוותים או מעוותות

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

  • 16x16 פיקסלים, עם קובץ בגודל של עד 1KB
  • 20x20 פיקסלים, עם קובץ בגודל מקסימלי של 1KB
  • 40x40 פיקסלים, עם קובץ בגודל מקסימלי של 1KB
  • 44x44 פיקסלים, עם קובץ בגודל מקסימלי של 1KB
  • 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 SotwcreApplication

חובה אם סופקו אפליקציות ל-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.

אם הספק לא מציע הפעלה ב-Android TV, זהו לא נכס נדרש.

application.identifier

טקסט

חובה אם רלוונטי – בפלטפורמות שתואמות לאחד מהערכים הבאים, יש להגדיר אותו בהתאם. המאפיין הזה אינו נדרש באופן אחר:

  • iOS: מזהה האפליקציה ב-App Store. לדוגמה: 967093455.
  • Android: שם החבילה ב-Android של חנות Play. לדוגמה, com.abc.media.android.
  • העברה: מזהה האפליקציה להעברה. לדוגמה: ACDA4FDE.
  • AndroidTV: שם החבילה בחנות Play ל-AndroidTV. לדוגמה, com.abc.media.atv.android.
parentOrganization ארגון

חובה – ספק ההורה של השירות.

parentOrganization.@type טקסט

חובה – תמיד מוגדר ל-Organization.

parentOrganization.name טקסט

חובה – שם הארגון.

subscriptions מינוי מדיה

אופציונלי – רשימת הספקים הזמינים בMediaSubscriptions.

baseSubscriptionTier מינוי מדיה

חובה אם זה רלוונטי – אם לספק שעון ולספק יש חבילת מינויים בסיסיים, צריך להגדיר זאת במופע המינוי לתוכן שזמין לכל המנויים. הנכס הזה אינו נדרש באופן אחר.

userRequestsFulfilledBy טקסט

אופציונלי – באחד מהשלבים הבאים:

  • Google: כל הבקשות ממולאות על ידי Google. למעשה, Google מחזירה את קישור העומק לתוכן המבוקש.
  • Provider: כל הבקשות ממולאות על ידי ספק התוכן – ספק שירותי הענן. למעשה, הספק מחזיר את קישור העומק עבור התוכן המבוקש, או יוזם את ההפעלה ישירות במכשירים שלו.

כברירת מחדל, המאפיין הזה מוגדר כ-Google.

mediaOffered טקסט

חובה – מגדירים אחד מסוגי התוכן הבאים, בהתאם לסוגי התוכן בקטלוג שכלולים בפיד:

דוגמה ל-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"
      }
    }
  ]
}