В этом разделе представлены подробные сведения о свойствах разметки контента для типа сущности MusicPlaylist .
Таблица технических характеристик
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
@context | Текст | Обязательно – всегда установлено значение ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type | Текст | Обязательно — для миксов всегда устанавливайте MusicPlaylist . |
@id | URL-адрес | Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .@id должен соответствовать следующим требованиям:
url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» . |
url | URL-адрес | Обязательно – канонический URL-адрес контента, который Google использует для сопоставления контента вашего фида с контентом в базах данных Google.url должен соответствовать следующим требованиям:
urlTemplate целевого объекта. |
name | Текст | Обязательно — название плейлиста, например «Funky Jazz Mix».
|
genre | Текст | Обязательно, если плейлист представляет собой смесь жанров . Список ключевых слов, специфичных для жанра, который представляет плейлист. Наличие этого свойства сигнализирует Google, что вы хотите, чтобы этот плейлист был жанровым. |
numTracks | Целое число | Обязательно, если плейлист представляет собой тщательно подобранный микс — количество треков в плейлисте. Наличие этого свойства сигнализирует Google, что этот плейлист создан вручную. Отсутствие этого свойства будет сигнализировать о том, что список воспроизведения является бесконечным, автоматически создаваемым списком воспроизведения. |
potentialAction | СлушайДействие | Обязательно — объект разметки Action , предоставляющий подробные сведения о действии. Подробности см. в свойствах разметки действий .
|
image | Объект изображения | Изображение списка воспроизведения, представляющее список воспроизведения или музыкальный микс. См. Свойства разметки изображения . |
creator | Организация или человек | Рекомендуется, если создатель вызывает большой интерес. Используйте это свойство, чтобы указать плейлисты, созданные вашей службой (введенные как Организация со свойством name , указывающим вашу службу) или пользователем с высоким интересом к вашей службе (введенным как Лицо со свойством name указывающим интересующего пользователя). |
keywords | Текст | Список ключевых слов («рок», «поп»), настроений («счастливый», «капризный»), занятий («упражнения», «расслабляющий») или других терминов, связанных с плейлистом. |
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."
}
Связанные страницы
На следующих страницах вы найдете темы, связанные с этими свойствами: