בקטע הזה מפורטים מאפייני התוכן של תגי העיצוב עבור סוגי הישויות 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 כתובת ה-URL צריכה לעמוד בדרישות הבאות:
urlTemplate של אובייקט היעד. |
name |
טקסט | חובה – שם האומן או הקבוצה.
|
potentialAction |
ListenAction | חובה – אובייקט של תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר בנושא מאפיינים של תגי עיצוב של פעולות.
|
subjectOf |
MusicPlaylist | חובה לגבי פעולות עם נתונים של ישויות – פרטים על פעולה עם נתונים של ישויות. |
subjectOf.@type |
טקסט | חובה לפעולות עם נתונים של ישויות – תמיד צריך להגדיר את המאפיין הזה לערך MusicPlaylist. |
subjectOf.@id |
כתובת URL | חובה לגבי פעולות עם נתונים של ישויות – המזהה של הפעולה עם נתונים של ישויות. אפשר לעיין בדרישות ל@id למעלה. הוא צריך להיות שונה מהערך @id של האומן או הלהקה. |
subjectOf.url |
כתובת URL | חובה לגבי פעולות עם נתונים של ישויות – כתובת ה-URL הקנונית של הפעולה עם נתונים של ישויות. אפשר לעיין בדרישות לurl למעלה. אפשר לדלג על השדה הזה אם הוא זהה לurl של האומן או הלהקה. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שמוזנות על ידי ישויות – אובייקט של תגי Action שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר בנושא מאפיינים של תגי עיצוב של פעולות.
|
image |
ImageObject | תמונה שמייצגת את MusicGroup. מאפייני תגי העיצוב של תמונות |
sameAs |
כתובת URL | כתובת URL לדף אינטרנט שבו אפשר לזהות את האומן, למשל דף ויקיפדיה של האומן. הערך הזה צריך להיות שונה מהערך של המאפיין url. |
description |
טקסט | ביוגרפיה קצרה של האמן/ית. מגבלה של 300 תווים.
|
isFamilyFriendly |
בוליאני | מציין אם התוכן הזה ידידותי למשפחות (כלומר, התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרי Google עשויים להשתמש בisFamilyFriendly כדי לקבוע איזה שיר להשמיע. |
popularityScore |
PopularityScoreSpecification | מומלץ מאוד למה? ציון ש-Google משתמשת בו, בנוסף לאותות אחרים, כדי לקבוע אילו מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מוגדר כ-0. |
popularityScore.@type |
טקסט | הערך תמיד יהיה PopularityScoreSpecification. |
popularityScore.value |
Number | ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר. |
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 כתובת ה-URL צריכה לעמוד בדרישות הבאות:
urlTemplate של אובייקט היעד. |
name |
טקסט | חובה – שם האלבום.
|
byArtist |
MusicGroup | חובה – האומן או הלהקה שהקליטו את האלבום. לפחות, צריך לציין את המזהה הייחודי @id שבו אתם משתמשים לאותו אמן ואת שם האמן. אם לאלבום יש כמה אמנים משויכים, אפשר לספק מערך של ערכים במאפיין byArtist. |
byArtist.@type |
טקסט | חובה – תמיד צריך להגדיר את הערך MusicGroup לנכס הזה. |
byArtist.@id |
כתובת URL | חובה – המזהה של האומן באלבום. אפשר לעיין בדרישות ל@id למעלה. הערך צריך להיות זהה לערך @id שבו השתמשתם כדי לציין את האומן או הלהקה במקום אחר בפיד. |
byArtist.name |
טקסט | חובה – שם האומן או הקבוצה. |
potentialAction |
ListenAction | חובה – אובייקט של תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר בנושא מאפיינים של תגי עיצוב של פעולות.
|
subjectOf |
MusicPlaylist | חובה לגבי פעולות עם נתונים של ישויות – פרטים על פעולה עם נתונים של ישויות. |
subjectOf.@type |
טקסט | חובה לפעולות עם נתונים של ישויות – תמיד צריך להגדיר את המאפיין הזה לערך MusicPlaylist. |
subjectOf.@id |
כתובת URL | חובה לגבי פעולות עם נתונים של ישויות – המזהה של הפעולה עם נתונים של ישויות. אפשר לעיין בדרישות ל@id למעלה. היא צריכה להיות שונה מ@id של האלבום. |
subjectOf.url |
כתובת URL | חובה לגבי פעולות עם נתונים של ישויות – כתובת ה-URL הקנונית של הפעולה עם נתונים של ישויות. אפשר לעיין בדרישות לurl למעלה. אפשר לדלג על השדה הזה אם הוא זהה לurl של האלבום. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שמוזנות על ידי ישויות – אובייקט של תגי Action שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר בנושא מאפיינים של תגי עיצוב של פעולות.
|
image |
ImageObject | תמונה שמייצגת את האלבום. מאפייני תגי העיצוב של תמונות |
sameAs |
כתובת URL | כתובת URL של דף אינטרנט שאפשר לזהות בו את האלבום, לדוגמה, דף ויקיפדיה של האלבום. הערך הזה צריך להיות שונה מהערך של המאפיין url. |
numTracks |
Integer | מספר השירים או הטראקים באלבום. |
timeRequired |
טקסט | אורך האלבום, בפורמט ISO 8601. |
description |
טקסט | תיאור קצר של האלבום. מגבלה של 300 תווים.
|
isFamilyFriendly |
בוליאני | מציין אם התוכן הזה ידידותי למשפחות (כלומר, התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרי Google עשויים להשתמש בisFamilyFriendly כדי לקבוע איזה שיר להשמיע. |
popularityScore |
PopularityScoreSpecification | ציון ש-Google משתמשת בו, בנוסף לאותות אחרים, כדי לקבוע אילו מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מוגדר כ-0. |
popularityScore.@type |
טקסט | הערך תמיד יהיה PopularityScoreSpecification. |
popularityScore.value |
Number | ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר. |
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 כתובת ה-URL צריכה לעמוד בדרישות הבאות:
urlTemplate של אובייקט היעד. |
name |
טקסט | חובה – שם השיר.
|
byArtist |
MusicGroup | חובה – האומן או הלהקה שהקליטו את השיר. לפחות, צריך לציין את המזהה הייחודי @id שבו אתם משתמשים לאותו אמן ואת שם האמן. אם לשיר יש כמה אמנים משויכים, אפשר לספק מערך של ערכים במאפיין byArtist. |
byArtist.@type |
טקסט | חובה – תמיד צריך להגדיר את הערך MusicGroup לנכס הזה. |
byArtist.@id |
כתובת URL | חובה – המזהה של האומן ששר את השיר. אפשר לעיין בדרישות ל@id למעלה. הערך צריך להיות זהה לערך @id שבו השתמשתם כדי לציין את האומן או הלהקה במקום אחר בפיד. |
byArtist.name |
טקסט | חובה – שם האומן או הקבוצה. |
potentialAction |
ListenAction | חובה – אובייקט של תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר בנושא מאפיינים של תגי עיצוב של פעולות.
|
subjectOf |
MusicPlaylist | חובה לגבי פעולות עם נתונים של ישויות – פרטים לגבי פעולה עם נתונים של ישויות |
subjectOf.@type |
טקסט | חובה לפעולות עם נתונים של ישויות – תמיד צריך להגדיר את המאפיין הזה לערך MusicPlaylist. |
subjectOf.@id |
כתובת URL | חובה לגבי פעולות עם נתונים של ישויות – המזהה של הפעולה עם נתונים של ישויות. אפשר לעיין בדרישות ל@id למעלה. הוא צריך להיות שונה מ-@id של השיר. |
subjectOf.url |
כתובת URL | חובה לגבי פעולות עם נתונים של ישויות – כתובת ה-URL הקנונית של הפעולה עם נתונים של ישויות. אפשר לעיין בדרישות לurl למעלה. אפשר לא לכלול את הערך הזה אם הוא זהה לערך url של השיר. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שמוזנות על ידי ישויות – אובייקט של תגי Action שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר בנושא מאפיינים של תגי עיצוב של פעולות.
|
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 |
Number | ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר. |
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"
}
}
}
}
}
דפים קשורים
במאמרים הבאים מפורטים נושאים שקשורים לנכסים האלה: