Свойства разметки контента музыкальных плейлистов

В этом разделе представлены подробные сведения о свойствах разметки контента для типа сущности MusicPlaylist .

Таблица технических характеристик

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

На следующих страницах вы найдете темы, связанные с этими свойствами: