این بخش جزئیات ویژگیهای نشانهگذاری محتوا را برای انواع MusicGroup
، MusicAlbum
و MusicRecording
ارائه میکند.
جدول مشخصات
گروه موسیقی
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
@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 که جزئیات عمل را ارائه می دهد. برای جزئیات بیشتر به ویژگی های نشانه گذاری اقدام مراجعه کنید.
|
subjectOf | لیست پخش موسیقی | مورد نیاز برای Entity-seeded Actions - جزئیات مربوط به اقدام seeded entity . |
subjectOf.@type | متن | برای کنشهای موجود در Entity مورد نیاز است - برای این ویژگی همیشه روی MusicPlaylist تنظیم شود. |
subjectOf.@id | URL | مورد نیاز برای Entity-seeded Actions - شناسه کنش موجودیت seeded. شرایط لازم برای @id در بالا ببینید. باید از @id هنرمند/گروه متمایز باشد. |
subjectOf.url | URL | مورد نیاز برای کنشهای مبتنی بر موجودیت - نشانی اینترنتی متعارف برای اقدام مبتنی بر نهاد. شرایط لازم برای url را در بالا ببینید. اگر همان url هنرمند/گروه باشد، میتوانید این را کنار بگذارید. |
subjectOf.potentialAction | ListenAction | مورد نیاز برای Entity-seeded Actions - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. برای جزئیات بیشتر به ویژگی های نشانه گذاری اقدام مراجعه کنید.
|
image | ImageObject | تصویری که نشان دهنده MusicGroup است. ویژگی های نشانه گذاری تصویر را ببینید. |
sameAs | URL | URL به یک صفحه وب مرجع که می تواند هنرمند را شناسایی کند. به عنوان مثال، صفحه ویکی پدیا هنرمند. این باید از ویژگی url متمایز باشد. |
description | متن | بیوگرافی مختصری از این هنرمند محدودیت 300 کاراکتر
|
isFamilyFriendly | بولی | نشان می دهد که آیا این محتوا برای خانواده مناسب است یا نه (یعنی محتوا برای همه اعضای یک خانواده از جمله کودکان مناسب است). هنگام تعیین آهنگی برای پخش، ممکن است محصولات Google از isFamilyFriendly استفاده کنند. |
popularityScore | PopularityScoreSpecification | بسیار توصیه می شود چرا؟ امتیازی که گوگل از آن بهعلاوه سیگنالهای دیگر استفاده میکند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است. |
popularityScore.@type | متن | همیشه روی PopularityScoreSpecification تنظیم شود. |
popularityScore.value | عدد | یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است. |
popularityScore.eligibleRegion | کشور | منطقه(های) جایی که این امتیاز محبوبیت قابل استفاده است. اگر امتیاز محبوبیت در سطح جهانی قابل اجرا است، روی EARTH تنظیم کنید. به طور پیش فرض، این ویژگی روی EARTH تنظیم شده است.Note: محبوبیت خاص محلی بر محبوبیت جهانی (EARTH) اولویت دارد |
آلبوم موسیقی
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
@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 | گروه موسیقی | مورد نیاز - هنرمند یا گروهی که این آلبوم را ضبط کرده است. حداقل باید شناسه @id منحصربهفردی که برای آن هنرمند استفاده میکنید و نام هنرمند را مشخص کنید. اگر آلبوم چندین هنرمند مرتبط دارد، میتوانید آرایهای از مقادیر را در byArtist ارائه کنید. |
byArtist.@type | متن | مورد نیاز - همیشه برای این ویژگی روی MusicGroup تنظیم شود. |
byArtist.@id | URL | الزامی - شناسه هنرمند آلبوم. شرایط لازم برای @id در بالا ببینید. باید با شناسه @id که برای هنرمند/گروه در جاهای دیگر فید خود استفاده میکنید مطابقت داشته باشد. |
byArtist.name | متن | الزامی - نام هنرمند/گروه. |
potentialAction | ListenAction | مورد نیاز - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. برای جزئیات بیشتر به ویژگی های نشانه گذاری اقدام مراجعه کنید.
|
subjectOf | لیست پخش موسیقی | مورد نیاز برای Entity-seeded Actions - جزئیات مربوط به اقدام seeded entity . |
subjectOf.@type | متن | برای کنشهای موجود در Entity مورد نیاز است - برای این ویژگی همیشه روی MusicPlaylist تنظیم شود. |
subjectOf.@id | URL | مورد نیاز برای Entity-seeded Actions - شناسه کنش موجودیت seeded. شرایط لازم برای @id در بالا ببینید. باید از @id آلبوم متمایز باشد. |
subjectOf.url | URL | مورد نیاز برای کنشهای مبتنی بر موجودیت - نشانی اینترنتی متعارف برای اقدام مبتنی بر نهاد. شرایط لازم برای url را در بالا ببینید. اگر همان url آلبوم باشد، میتوانید این را کنار بگذارید. |
subjectOf.potentialAction | ListenAction | مورد نیاز برای Entity-seeded Actions - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. برای جزئیات بیشتر به ویژگی های نشانه گذاری اقدام مراجعه کنید.
|
image | ImageObject | تصویری که نمایانگر آلبوم موسیقی است. ویژگی های نشانه گذاری تصویر را ببینید. |
sameAs | URL | URL به یک صفحه وب مرجع که می تواند آلبوم را شناسایی کند. به عنوان مثال، صفحه ویکی پدیا آلبوم. این باید از ویژگی url متمایز باشد. |
numTracks | عدد صحیح | تعداد آهنگ ها یا آهنگ های این آلبوم. |
timeRequired | متن | طول آلبوم، با فرمت ISO 8601 . |
description | متن | توضیح مختصری از آلبوم. محدودیت 300 کاراکتر
|
isFamilyFriendly | بولی | نشان می دهد که آیا این محتوا برای خانواده مناسب است یا نه (یعنی محتوا برای همه اعضای یک خانواده از جمله کودکان مناسب است). هنگام تعیین آهنگی برای پخش، ممکن است محصولات Google از isFamilyFriendly استفاده کنند. |
popularityScore | PopularityScoreSpecification | امتیازی که گوگل از آن بهعلاوه سیگنالهای دیگر استفاده میکند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است. |
popularityScore.@type | متن | همیشه روی PopularityScoreSpecification تنظیم شود. |
popularityScore.value | عدد | یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است. |
popularityScore.eligibleRegion | کشور | منطقه(های) جایی که این امتیاز محبوبیت قابل استفاده است. اگر امتیاز محبوبیت در سطح جهانی قابل اجرا است، روی EARTH تنظیم کنید. به طور پیش فرض، این ویژگی روی EARTH تنظیم شده است. |
ضبط موسیقی
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
@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 | گروه موسیقی | مورد نیاز - هنرمند یا گروهی که این آهنگ را ضبط کرده است. حداقل باید شناسه @id منحصربهفردی که برای آن هنرمند استفاده میکنید و نام هنرمند را مشخص کنید. اگر آهنگ دارای چندین هنرمند مرتبط است، میتوانید آرایهای از مقادیر را در byArtist ارائه کنید. |
byArtist.@type | متن | مورد نیاز - همیشه برای این ویژگی روی MusicGroup تنظیم شود. |
byArtist.@id | URL | الزامی - شناسه هنرمند آهنگ. شرایط لازم برای @id در بالا ببینید. باید با شناسه @id که برای هنرمند/گروه در جاهای دیگر فید خود استفاده میکنید مطابقت داشته باشد. |
byArtist.name | متن | الزامی - نام هنرمند/گروه. |
potentialAction | ListenAction | مورد نیاز - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. برای جزئیات بیشتر به ویژگی های نشانه گذاری اقدام مراجعه کنید.
|
subjectOf | لیست پخش موسیقی | مورد نیاز برای Entity-seeded Actions - جزئیات مربوط به عمل seeded موجودیت |
subjectOf.@type | متن | برای کنشهای موجود در Entity مورد نیاز است - برای این ویژگی همیشه روی MusicPlaylist تنظیم شود. |
subjectOf.@id | URL | مورد نیاز برای Entity-seeded Actions - شناسه کنش موجودیت seeded. شرایط لازم برای @id در بالا ببینید. باید از @id آهنگ متمایز باشد. |
subjectOf.url | URL | مورد نیاز برای کنشهای مبتنی بر موجودیت - نشانی اینترنتی متعارف برای اقدام مبتنی بر نهاد. شرایط لازم برای url را در بالا ببینید. اگر همان url آهنگ است، میتوانید این را کنار بگذارید. |
subjectOf.potentialAction | ListenAction | مورد نیاز برای Entity-seeded Actions - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. برای جزئیات بیشتر به ویژگی های نشانه گذاری اقدام مراجعه کنید.
|
image | ImageObject | تصویری که نمایانگر MusicRecording است. ویژگی های نشانه گذاری تصویر را ببینید. |
sameAs | URL | URL به یک صفحه وب مرجع که می تواند آلبوم را شناسایی کند. به عنوان مثال، صفحه ویکی پدیا آلبوم. این باید از ویژگی url متمایز باشد. |
inAlbum | آلبوم موسیقی | آلبومی که آهنگ در آن ظاهر می شود، در صورت وجود. |
inAlbum.@type | متن | برای این ویژگی همیشه روی MusicAlbum تنظیم شود. |
inAlbum.@id | URL | شناسه آلبوم شرایط لازم برای @id در بالا ببینید. باید با شناسه @id که برای آلبوم در جاهای دیگر فید خود استفاده میکنید مطابقت داشته باشد. |
inAlbum.name | متن | نام آلبوم. |
duration | متن | طول آهنگ با فرمت ISO 8601 . |
description | متن | شرح مختصری از آهنگ. محدودیت 300 کاراکتر
|
isFamilyFriendly | بولی | نشان می دهد که آیا این محتوا برای خانواده مناسب است یا نه (یعنی محتوا برای همه اعضای یک خانواده از جمله کودکان مناسب است). هنگام تعیین آهنگی برای پخش، ممکن است محصولات Google از isFamilyFriendly استفاده کنند. |
popularityScore | PopularityScoreSpecification | امتیازی که گوگل از آن بهعلاوه سیگنالهای دیگر استفاده میکند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است. |
popularityScore.@type | متن | همیشه روی PopularityScoreSpecification تنظیم شود. |
popularityScore.value | عدد | یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است. |
popularityScore.eligibleRegion | کشور | منطقه(های) جایی که این امتیاز محبوبیت قابل استفاده است. اگر امتیاز محبوبیت در سطح جهانی قابل اجرا است، روی EARTH تنظیم کنید. به طور پیش فرض، این ویژگی روی EARTH تنظیم شده است. |
مثال ها
گروه موسیقی
{
"@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"
}
}
}
}
}
آلبوم موسیقی
{
"@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"
}
}
}
}
}
ضبط موسیقی
{
"@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"
}
}
}
}
}
صفحات مرتبط
برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید: