המקטע הזה מספק את הפרטים של מאפייני תגי העיצוב של תוכן עבור סוגי הישויות 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 | חובה – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני תגי עיצוב של פעולה.
|
subjectOf |
MusicPlaylist | נדרש עבור פעולות של ישויות שקיבלו שיוך (Entity) - פרטים על הפעולה שבוצעה על ידי ישויות. |
subjectOf.@type |
טקסט | חובה לפעולות שבוצעו על ידי ישויות – תמיד מוגדר הערך MusicPlaylist לנכס הזה. |
subjectOf.@id |
כתובת URL | חובה לפעולות שמיוחסות לישות – המזהה של הפעולה שמשויכת לישות. יש לעיין בדרישות לגבי @id למעלה. הוא חייב להיות שונה מה-@id של האומן/הקבוצה. |
subjectOf.url |
כתובת URL | חובה לפעולות שמיוחסות לישות – כתובת ה-URL הקנונית של הפעולה שבוצעה על ידי ישות. יש לעיין בדרישות לגבי url למעלה. אפשר להעלים את האפשרות הזו אם היא זהה ל-url של האומן/הקבוצה. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שעברו זרוע (Entity) – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני תגי עיצוב של פעולה.
|
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 | חובה – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני תגי עיצוב של פעולה.
|
subjectOf |
MusicPlaylist | נדרש עבור פעולות של ישויות שקיבלו שיוך (Entity) - פרטים על הפעולה שבוצעה על ידי ישויות. |
subjectOf.@type |
טקסט | חובה לפעולות שבוצעו על ידי ישויות – תמיד מוגדר הערך MusicPlaylist לנכס הזה. |
subjectOf.@id |
כתובת URL | חובה לפעולות שמיוחסות לישות – המזהה של הפעולה שמשויכת לישות. יש לעיין בדרישות לגבי @id למעלה. הוא צריך להיות שונה מה@id של האלבום. |
subjectOf.url |
כתובת URL | חובה לפעולות שבוצעו על ידי ישויות – כתובת ה-URL הקנונית של הפעולה שבוצעה על ידי ישות. יש לעיין בדרישות לגבי url למעלה. אפשר להסיר אותה אם היא זהה לurl של האלבום. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שעברו זרוע (Entity) – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני תגי עיצוב של פעולה.
|
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 | חובה – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני תגי עיצוב של פעולה.
|
subjectOf |
MusicPlaylist | חובה לגבי פעולות שמיוחסות לישויות – פרטים על הפעולה שמבוצעת על ידי ישויות |
subjectOf.@type |
טקסט | חובה לפעולות שבוצעו על ידי ישויות – תמיד מוגדר הערך MusicPlaylist לנכס הזה. |
subjectOf.@id |
כתובת URL | חובה לפעולות שמיוחסות לישות – המזהה של הפעולה שמשויכת לישות. יש לעיין בדרישות לגבי @id למעלה. השיר צריך להיות שונה מה@id של השיר. |
subjectOf.url |
כתובת URL | חובה לפעולות שמיוחסות לישות – כתובת ה-URL הקנונית של הפעולה שבוצעה על ידי ישות. יש לעיין בדרישות לגבי url למעלה. אפשר להחריג את האפשרות הזו אם היא זהה לurl של השיר. |
subjectOf.potentialAction |
ListenAction | חובה לפעולות שעברו זרוע (Entity) – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני תגי עיצוב של פעולה.
|
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"
}
}
}
}
}
דפים קשורים
בדפים הבאים תוכלו למצוא נושאים שקשורים לנכסים האלה: