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

В этом разделе представлены сведения о свойствах разметки содержимого для типа объекта 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 ListenAction Обязательныйобъект разметки Action , предоставляющий сведения о действии. Подробнее см. в свойствах разметки Action .
image ImageObject Изображение списка воспроизведения, представляющее список воспроизведения или музыкальный микс. См. раздел Свойства разметки изображения .
creator Организация или лицо Рекомендуется, если создатель представляет большой интерес. Используйте это свойство, чтобы указать плейлисты, созданные вашей службой (вводится как Организация со свойством name , указывающим вашу службу) или пользователем, проявляющим большой интерес к вашей службе (вводится как Человек со свойством name , указывающим интересующего пользователя).
keywords Текст Список ключевых слов («рок», «поп»), настроений («счастливый», «капризный»), действий («упражнения», «расслабление») или других терминов, связанных с плейлистом.
description Текст Краткое описание плейлиста. ограничение в 300 символов.
isFamilyFriendly логический Указывает, подходит ли этот контент для всей семьи (то есть подходит ли контент для всех членов семьи, включая детей). Продукты Google могут использовать isFamilyFriendly при выборе песни для воспроизведения.
popularityScore PopularityScoreSpecification Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0.
popularityScore.@type Текст Всегда устанавливайте PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью.

Пример

Пример, который содержит составленный вручную плейлист поп-песен 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."
}

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