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

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

טבלת מפרט

נכס הסוג הנדרש תיאור
@context טקסט חובה – תמיד מוגדר ל-["http://schema.googleapis.com", {"@language": "xx"}].
  • כאשר 'xx' מייצג את שפת המחרוזות בפיד. לכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השדה @language לקוד השפה המתאים בפורמט BCP 47. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות יהיו בספרדית גם אם שפת הכתוביות או הדיבוב היא אנגלית.
@type טקסט חובה – תמיד מוגדר לערך MusicPlaylist במיקסים.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודיים ברמת הקטלוג
  • סטטי. המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית ישתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל.
  • כמזהה משאב אחיד (URI)
  • הדומיין שבו נעשה שימוש בערך @id חייב להיות בבעלות הארגון.
מכיוון שהשדה url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
url כתובת URL חובה – כתובת ה-URL הקנונית של התוכן, שבה Google משתמשת כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.
url חייבת לעמוד בדרישות הבאות:
  • השדה url חייב להיות ייחודי ברמת המערכת
  • השדה url חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק.
  • url צריך להפנות לדף תיאור תוכן שלא חסום על ידי מחסום תשלום.
קישור העומק של ההפעלה מופיע במקום זאת במאפיין urlTemplate של האובייקט היעד.
name טקסט חובה – שם הפלייליסט, לדוגמה 'Funky Jazz Mix'.
genre טקסט חובה אם הפלייליסט הוא שילוב של ז'אנרים – רשימת מילות מפתח ספציפיות לז'אנר שמייצג הפלייליסט. נוכחות המאפיין הזה מאותת ל-Google שהפלייליסט הזה מיועד להיות פלייליסט ז'אנר.
numTracks Integer חובה אם הפלייליסט הוא מיקס שנוצר על ידי צוות – מספר הטראקים בפלייליסט. נוכחות המאפיין הזה מאותת ל-Google שהפלייליסט הזה נוצר באופן ידני. אם המאפיין הזה לא יופיע, סימן שהפלייליסט הוא פלייליסט אינסופי שנוצר באופן אוטומטי.
potentialAction ListenAction חובה – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
image ImageObject תמונה של פלייליסט שמייצגת את הפלייליסט או את מיקס המוזיקה. מאפייני תגי עיצוב של תמונות
creator ארגון או אדם מומלץ אם היוצר מעורר עניין רב. משתמשים במאפיין הזה כדי לציין את הפלייליסטים שנוצרו על ידי השירות (מקלידים Organization ומזינים את המאפיין name שמייצג את השירות) או משתמש עם תחום עניין רלוונטי בשירות (מקלידים Person ומזינים את המאפיין name שמייצג את המשתמש הרלוונטי).
keywords טקסט רשימה של מילות מפתח ('רוק', 'פופ'), מצבי רוח ('שמחה', 'דכדוך'), פעילויות ('פעילות גופנית', 'רגיעה') או מונחים אחרים שקשורים לפלייליסט.
description טקסט תיאור קצר של הפלייליסט. מגבלת תווים של 300.
isFamilyFriendly בוליאני מציין אם התוכן הזה ידידותי לכל המשפחה (כלומר, התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרים של Google עשויים להשתמש ב-isFamilyFriendly כדי לקבוע איזה שיר להשמיע.
popularityScore PopularityScoreSpecification מומלץ מאוד למה? ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0.
popularityScore.@type טקסט הערך תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value מספר ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר.
popularityScore.eligibleRegion מדינה האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-EARTH. כברירת מחדל, הנכס הזה מוגדר ל-EARTH.
Note: הפופולריות הספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)

דוגמה

דוגמה לפלייליסט שנוצר ביד עם שירים מהתקופה של שנות ה-2010:

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicPlaylist",
  "@id":"http://www.example.com/playlist/top-pop-songs/",
  "url":"http://www.example.com/playlist/top-pop-songs/",
  "name":"Top Pop Songs of the 2010s",
  "image":[
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo1.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["US","UK","MX"]
  },
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo2.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["UA", "IR"]
  }],
  "genre": [
     "pop",
     "2010s"
  ],
  "numTracks":"46",
  "potentialAction":{
    "@type":"ListenAction",
    "target":[
      {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/playlist/top-pop-songs?autoplay=true",
        "actionPlatform":[
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform",
          "http://schema.googleapis.com/GoogleAudioCast",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.app.example/playlist/top-pop-songs?autoplay=true",
        "actionPlatform": "http://schema.org/AndroidPlatform"
      }
    ],
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"free",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "creator": {
    "@type": "Organization",
    "name": "example.com"
  },
  "keywords": [
    "pop",
    "Party music"
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description":"Top pop songs from the last decade."
}

בדפים הבאים מפורטים נושאים שקשורים לנכסים האלה: