בקטע הזה מפורטים המאפיינים של תגי העיצוב של התוכן עבור סוגי הישויות MusicGroup
, MusicAlbum
ו-MusicRecording
.
טבלת מפרט
MusicGroup
נכס | הסוג הנדרש | תיאור |
---|---|---|
@context |
טקסט | חובה – תמיד מוגדר ל-["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
טקסט | חובה – תמיד מוגדר ל-MusicGroup עבור אמנים ולהקות. |
@id |
כתובת URL | חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id . פרטים נוספים זמינים בקטע מזהה. |
url |
כתובת URL | חובה – כתובת ה-URL הקנונית של התוכן, שבה Google משתמשת כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.url חייבת לעמוד בדרישות הבאות:
urlTemplate של האובייקט היעד. |
name |
טקסט | חובה – שם האומן או הקבוצה.
|
potentialAction |
ListenAction | חובה – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
subjectOf |
MusicPlaylist | חובה לפעולות שמבוססות על ישויות – פרטים לגבי הפעולה שמבוססת על ישות. |
subjectOf.@type |
טקסט | חובה לפעולות שמבוססות על ישויות – תמיד צריך להגדיר את הערך MusicPlaylist לנכס הזה. |
subjectOf.@id |
כתובת URL | חובה לפעולות שמבוססות על ישות – המזהה של הפעולה שמבוססת על ישות. אפשר לעיין בדרישות ל-@id למעלה. הוא חייב להיות שונה מ-@id של האומן/ה או של הלהקה. |
subjectOf.url |
כתובת URL | חובה לפעולות שמבוססות על ישויות – כתובת ה-URL הקנונית של הפעולה שמבוססת על ישות. אפשר לעיין בדרישות ל-url למעלה. אפשר להשמיט את השדה הזה אם הוא זהה לשדה url של האומן או הקבוצה. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שמבוססות על ישויות – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
image |
ImageObject | תמונה שמייצגת את MusicGroup. מאפייני תגי עיצוב של תמונות |
sameAs |
כתובת URL | כתובת URL לדף אינטרנט של עזרה שיכול לזהות את האומן. לדוגמה, דף האומן בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין url . |
description |
טקסט | ביוגרפיה קצרה של האמן/ית. מגבלת תווים של 300.
|
isFamilyFriendly |
בוליאני | מציין אם התוכן הזה ידידותי לכל המשפחה (כלומר, התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרים של Google עשויים להשתמש ב-isFamilyFriendly כדי לקבוע איזה שיר להשמיע. |
popularityScore |
PopularityScoreSpecification | מומלץ מאוד למה? ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0. |
popularityScore.@type |
טקסט | הערך תמיד מוגדר ל-PopularityScoreSpecification . |
popularityScore.value |
מספר | ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר. |
popularityScore.eligibleRegion |
מדינה | האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-EARTH . כברירת מחדל, הנכס הזה מוגדר ל-EARTH . Note: הפופולריות הספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH) |
MusicAlbum
נכס | הסוג הנדרש | תיאור |
---|---|---|
@context |
טקסט | חובה – תמיד מוגדר ל-["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
טקסט | חובה – תמיד מוגדר ל-MusicAlbum לאלבומים. |
@id |
כתובת URL | חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id . פרטים נוספים זמינים בקטע מזהה. |
url |
כתובת URL | חובה – כתובת ה-URL הקנונית של התוכן, שבה Google משתמשת כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.url חייבת לעמוד בדרישות הבאות:
urlTemplate של האובייקט היעד. |
name |
טקסט | חובה – שם האלבום.
|
byArtist |
MusicGroup | חובה – האומן או הקבוצה שהקליטו את האלבום הזה. עליכם לציין לפחות את הערך הייחודי של @id שבו אתם משתמשים לאמן ואת שם האמן. אם לאלבום יש כמה אומנים משויכים, אפשר לספק מערך ערכים ב-byArtist. |
byArtist.@type |
טקסט | חובה – תמיד צריך להגדיר את הערך MusicGroup לנכס הזה. |
byArtist.@id |
כתובת URL | חובה – המזהה של האומן של האלבום. אפשר לעיין בדרישות ל-@id למעלה. הוא צריך להתאים ל-@id שבו אתם משתמשים עבור האומן/ה או הקבוצה במקום אחר בפיד. |
byArtist.name |
טקסט | חובה – שם האומן או הקבוצה. |
potentialAction |
ListenAction | חובה – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
subjectOf |
MusicPlaylist | חובה לפעולות שמבוססות על ישויות – פרטים לגבי הפעולה שמבוססת על ישות. |
subjectOf.@type |
טקסט | חובה לפעולות שמבוססות על ישויות – תמיד צריך להגדיר את הערך MusicPlaylist לנכס הזה. |
subjectOf.@id |
כתובת URL | חובה לפעולות שמבוססות על ישות – המזהה של הפעולה שמבוססת על ישות. אפשר לעיין בדרישות ל-@id למעלה. הוא חייב להיות שונה מה-@id של האלבום. |
subjectOf.url |
כתובת URL | חובה לפעולות שמבוססות על ישויות – כתובת ה-URL הקנונית של הפעולה שמבוססת על ישות. אפשר לעיין בדרישות ל-url למעלה. אפשר להשמיט את השדה הזה אם הוא זהה ל-url של האלבום. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שמבוססות על ישויות – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
image |
ImageObject | תמונה שמייצגת את MusicAlbum. מאפייני תגי עיצוב של תמונות |
sameAs |
כתובת URL | כתובת URL לדף אינטרנט של עזרה שיכול לזהות את האלבום. לדוגמה, דף האלבום בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין url . |
numTracks |
Integer | מספר השירים או הטראקים באלבום הזה. |
timeRequired |
טקסט | אורך האלבום, בפורמט ISO 8601. |
description |
טקסט | תיאור קצר של האלבום. מגבלת תווים של 300.
|
isFamilyFriendly |
בוליאני | מציין אם התוכן הזה ידידותי לכל המשפחה (כלומר, התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרים של Google עשויים להשתמש ב-isFamilyFriendly כדי לקבוע איזה שיר להשמיע. |
popularityScore |
PopularityScoreSpecification | ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0. |
popularityScore.@type |
טקסט | הערך תמיד מוגדר ל-PopularityScoreSpecification . |
popularityScore.value |
מספר | ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר. |
popularityScore.eligibleRegion |
מדינה | האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-EARTH . כברירת מחדל, הנכס הזה מוגדר ל-EARTH . |
MusicRecording
נכס | הסוג הנדרש | תיאור |
---|---|---|
@context |
טקסט | חובה – תמיד מוגדר ל-["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
טקסט | חובה – תמיד מוגדר ל-MusicRecording בשירים או בטראקים. |
@id |
כתובת URL | חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id . פרטים נוספים זמינים בקטע מזהה. |
url |
כתובת URL | חובה – כתובת ה-URL הקנונית של התוכן, שבה Google משתמשת כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.url חייבת לעמוד בדרישות הבאות:
urlTemplate של האובייקט היעד. |
name |
טקסט | חובה – שם השיר.
|
byArtist |
MusicGroup | חובה – האומן או הקבוצה שהקליטו את השיר הזה. עליכם לציין לפחות את הערך הייחודי של @id שבו אתם משתמשים לאמן ואת שם האמן. אם לשיר יש כמה אומנים משויכים, אפשר לספק מערך ערכים ב-byArtist. |
byArtist.@type |
טקסט | חובה – תמיד צריך להגדיר את הערך MusicGroup לנכס הזה. |
byArtist.@id |
כתובת URL | חובה – המזהה של האומן של השיר. אפשר לעיין בדרישות ל-@id למעלה. הוא צריך להתאים ל-@id שבו אתם משתמשים עבור האומן/ה או הקבוצה במקום אחר בפיד. |
byArtist.name |
טקסט | חובה – שם האומן או הקבוצה. |
potentialAction |
ListenAction | חובה – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
subjectOf |
MusicPlaylist | חובה לפעולות שמבוססות על ישויות – פרטים לגבי הפעולה שמבוססת על ישות |
subjectOf.@type |
טקסט | חובה לפעולות שמבוססות על ישויות – תמיד צריך להגדיר את הערך MusicPlaylist לנכס הזה. |
subjectOf.@id |
כתובת URL | חובה לפעולות שמבוססות על ישות – המזהה של הפעולה שמבוססת על ישות. אפשר לעיין בדרישות ל-@id למעלה. הוא חייב להיות שונה מ-@id של השיר. |
subjectOf.url |
כתובת URL | חובה לפעולות שמבוססות על ישויות – כתובת ה-URL הקנונית של הפעולה שמבוססת על ישות. אפשר לעיין בדרישות ל-url למעלה. אפשר להשאיר את השדה הזה ריק אם הוא זהה ל-url של השיר. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שמבוססות על ישויות – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
image |
ImageObject | תמונה שמייצגת את MusicRecording. מאפייני תגי עיצוב של תמונות |
sameAs |
כתובת URL | כתובת URL לדף אינטרנט של עזרה שיכול לזהות את האלבום. לדוגמה, דף האלבום בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין url . |
inAlbum |
MusicAlbum | האלבום שבו מופיע הטראק, אם יש כזה. |
inAlbum.@type |
טקסט | תמיד מוגדר ל-MusicAlbum בנכס הזה. |
inAlbum.@id |
כתובת URL | המזהה של האלבום. אפשר לעיין בדרישות ל-@id למעלה. הוא חייב להתאים ל-@id שבו אתם משתמשים באלבום במקום אחר בפיד. |
inAlbum.name |
טקסט | שם האלבום. |
duration |
טקסט | אורך השיר, בפורמט ISO 8601. |
description |
טקסט | תיאור קצר של השיר. מגבלת תווים של 300.
|
isFamilyFriendly |
בוליאני | מציין אם התוכן הזה ידידותי לכל המשפחה (כלומר, התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרים של Google עשויים להשתמש ב-isFamilyFriendly כדי לקבוע איזה שיר להשמיע. |
popularityScore |
PopularityScoreSpecification | ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0. |
popularityScore.@type |
טקסט | הערך תמיד מוגדר ל-PopularityScoreSpecification . |
popularityScore.value |
מספר | ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר. |
popularityScore.eligibleRegion |
מדינה | האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-EARTH . כברירת מחדל, הנכס הזה מוגדר ל-EARTH . |
דוגמאות
MusicGroup
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicGroup",
"@id":"http://www.example.com/artist/my_favorite_artist/",
"url":"http://www.example.com/artist/my_favorite_artist/",
"sameAs": "http://www.my_favorite_artist.com",
"name":"My Favorite Artist",
"description":"This is my favorite artist.",
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favortie_artist/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 92,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/artist_mix/my_favorite_artist/",
"url":"http://www.example.com/artist_mix/my_favorite_artist/",
"name":"My Favorite Artist Mix",
"description":"A playlist of songs similar to My Favorite Artist",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicAlbum
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"url":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_album_(my_favorite_artist_album)",
"description":"This is my favorite album.",
"datePublished":"2010-08-24",
"numTracks":"12",
"timeRequired":"P44M02S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_artist/",
"name":"My Favorite Artist"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 87,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/album_mix/my_favorite_album",
"url":"http://www.example.com/album_mix/my_favorite_album",
"name":"My Favorite Album Mix",
"description":"A playlist of songs similar to My Favorite Album",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album_mix/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicRecording
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicRecording",
"@id":"http://www.example.com/track/my_favorite_song",
"url":"http://www.example.com/track/my_favorite_song",
"name":"My Favorite Song",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_song_(song)",
"description":"This is my favorite song.",
"datePublished":"2010-08-24",
"duration":"PT3M54S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_song/",
"name":"My Favorite Artist"
},
"inAlbum":{
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 97,
"eligibleRegion": "EARTH"
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track/my_favorite_song?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"
]
},
"expectsAcceptanceOf": {
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/track_mix/my_favorite_song",
"url":"http://www.example.com/track_mix/my_favorite_song",
"name":"My Favorite Song Mix",
"description":"A playlist of songs similar to My Favorite Song",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track_mix/my_favorite_song?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
דפים קשורים
בדפים הבאים מפורטים נושאים שקשורים לנכסים האלה: