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

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

טבלת מפרט

מאפיין (property) הסוג הנדרש תיאור
@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 חייב להכיל כתובת אתר קנונית תקינה ש-Google יכולה לסרוק.
  • url צריך להפנות לדף תיאור תוכן שאינו חסום על ידי חומת תשלום.
לקישור עומק של הפעלה, ראו במקום זאת את מאפיין היעד של urlTemplate.
name טקסט חובה – שם הפלייליסט, לדוגמה "Funky Jezz Mix".
genre טקסט חובה אם הפלייליסט הוא מיקס של ז'אנר – רשימה של מילות מפתח ספציפיות לז'אנר שהפלייליסט מייצג. הנוכחות של הנכס הזה מסמנת ל-Google שהכוונת שלכם היא פלייליסט של ז'אנר.
numTracks Integer חובה אם הפלייליסט הוא מיקס משולב – מספר הטראקים בפלייליסט. הנוכחות של הנכס הזה מסמנת ל-Google שהפלייליסט הזה נוצר באופן ידני. חסר הנכס הזה כדי לציין שהפלייליסט הוא פלייליסט אינסופי שנוצר באופן אוטומטי.
potentialAction ListenAction חובה – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים בקטע מאפיינים של תגי עיצוב של פעולות.
image אובייקט תמונה תמונת פלייליסט שמייצגת את הפלייליסט או את תמהיל המוזיקה. מומלץ לעיין במאפיינים של תגי עיצוב של תמונות.
creator ארגון או אדם מומלץ אם היוצר הוא בעל עניין גבוה. השתמשו בנכס הזה כדי לציין את הפלייליסטים שנוצרו על ידי השירות שלכם (מקלידים ארגון עם מאפיין name שלו הוא השירות שלכם) או משתמש בעל התעניינות גבוהה בשירות (מקלידים אדם עם מאפיין name שלו, המציין את המשתמש בעל העניין).
keywords טקסט רשימה של מילות מפתח ("rock", "pop"), מצבי רוח ("Happy", "moody"), פעילויות ("exercise", "relaxing") או מונחים אחרים הקשורים לפלייליסט.
description טקסט תיאור קצר של הפלייליסט. מגבלה של 300 תווים.
isFamilyFriendly ערך בוליאני מציין אם התוכן מתאים לכל המשפחה (כלומר, התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרי Google עשויים להשתמש בisFamilyFriendly כדי לקבוע איזה שיר להשמיע.
popularityScore מפרט פופולרי מומלץ מאוד למה? ציון שמשמש את 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."
}

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