Свойства разметки контента исполнителей, альбомов и песен

В этом разделе представлены подробные сведения о свойствах разметки содержимого для типов сущностей MusicGroup , MusicAlbum и MusicRecording .

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

Музыкальная группа

Свойство Ожидаемый тип Описание
@context Текст Обязательно - Всегда устанавливайте значение ["http://schema.googleapis.com", {"@language": "xx"}] .
  • Где "xx" обозначает язык строк в потоке. Для каждого контекста корневой сущности параметр @language должен быть установлен на соответствующий код языка в формате BCP 47. Например, если язык установлен на испанский, предполагается, что имена будут на испанском, даже если язык субтитров/дубляжа — английский.
@type Текст Обязательно — для исполнителей и групп всегда устанавливайте значение MusicGroup .
@id URL Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Уникальный дизайн во всем вашем каталоге.
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство url объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой.
  • В форме унифицированного идентификатора ресурса (URI)
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать url сущности в формате @id . Более подробную информацию см. в разделе «Идентификатор» .
url URL Обязательно — канонический URL-адрес контента, который Google использует для сопоставления контента в вашей ленте с контентом в базах данных Google.
url должен соответствовать следующим требованиям:
  • url должен быть уникальным во всем мире.
  • url должен содержать рабочий канонический URL, который Google может проиндексировать.
  • url должен указывать на страницу описания контента, не заблокированную платным доступом.
Для воспроизведения прямой ссылки используйте свойство urlTemplate целевого объекта.
name Текст Обязательно укажите имя исполнителя или группы.
potentialAction ListenAction Обязательный параметр — объект разметки действия , содержащий подробную информацию о действии. См. свойства разметки действия для получения более подробной информации.
subjectOf Музыкальный плейлист Обязательно для действий, инициализируемых сущностью — Подробная информация о действии, инициализированном сущностью .
subjectOf.@type Текст Обязательно для действий, инициализируемых сущностью . Для этого свойства всегда устанавливайте значение MusicPlaylist .
subjectOf.@id URL Обязательный параметр для действий, инициализируемых сущностью — идентификатор действия, инициализируемого сущностью. См. требования к @id выше. Он должен отличаться от @id для исполнителя/группы.
subjectOf.url URL Обязательно для действий, инициализируемых сущностью — канонический URL для такого действия. См. требования к url выше. Вы можете опустить этот параметр, если он совпадает с url исполнителя/группы.
subjectOf.potentialAction ListenAction Для действий, инициализируемых сущностью, требуется объект разметки действия , предоставляющий подробную информацию о действии. См. свойства разметки действия для получения более подробной информации.
image ImageObject Изображение, представляющее MusicGroup. См. свойства разметки изображения .
sameAs URL URL-адрес веб-страницы, позволяющей идентифицировать художника; например, страница художника в Википедии. Этот адрес должен отличаться от свойства url .
description Текст Краткая биография художника. Ограничение: 300 символов.
isFamilyFriendly Логический Указывает, подходит ли данный контент для семейного просмотра (то есть, подходит ли он для всех членов семьи, включая детей). Продукты Google могут использовать isFamilyFriendly при определении песни для воспроизведения.
popularityScore Спецификация показателя популярности Настоятельно рекомендуется. Почему? Это показатель, который Google использует, а также другие сигналы, чтобы определить, какой контент показывать пользователям. Этот показатель отражает популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала показателя должна быть одинаковой во всех ваших фидах, для всех объектов в вашем каталоге. По умолчанию показатель популярности объекта установлен на 0.
popularityScore.@type Текст Всегда устанавливайте значение PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), к которому(ым) применима данная оценка популярности. Если оценка популярности применима во всем мире, установите значение EARTH . По умолчанию это свойство имеет значение EARTH .
Note: популярность, специфичная для данного региона, имеет приоритет над глобальной (земной) популярностью.

Музыкальный альбом

Свойство Ожидаемый тип Описание
@context Текст Обязательно - Всегда устанавливайте значение ["http://schema.googleapis.com", {"@language": "xx"}] .
  • Где "xx" обозначает язык строк в потоке. Для каждого контекста корневой сущности параметр @language должен быть установлен на соответствующий код языка в формате BCP 47. Например, если язык установлен на испанский, предполагается, что имена будут на испанском, даже если язык субтитров/дубляжа — английский.
@type Текст Обязательно — для альбомов всегда выбирайте MusicAlbum .
@id URL Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Уникальный дизайн во всем вашем каталоге.
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство url объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой.
  • In the form of Unified Resource Identifier (URI)
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать url сущности в формате @id . Более подробную информацию см. в разделе «Идентификатор» .
url URL Обязательно — канонический URL-адрес контента, который Google использует для сопоставления контента в вашей ленте с контентом в базах данных Google.
url must meet the following requirements:
  • url должен быть уникальным во всем мире.
  • url должен содержать рабочий канонический URL, который Google может проиндексировать.
  • url должен указывать на страницу описания контента, не заблокированную платным доступом.
Для воспроизведения прямой ссылки используйте свойство urlTemplate целевого объекта.
name Текст Обязательно — название альбома.
byArtist Музыкальная группа Обязательно — укажите исполнителя или группу, записавшую этот альбом. Как минимум, необходимо указать уникальный @id , используемый для этого исполнителя, и имя исполнителя. Если с альбомом связано несколько исполнителей, вы можете указать массив значений в byArtist.
byArtist.@type Текст Обязательно — для этого свойства всегда устанавливайте значение MusicGroup .
byArtist.@id URL Обязательно — идентификатор исполнителя альбома. См. требования к @id выше. Он должен совпадать с @id который вы используете для исполнителя/группы в других местах вашей ленты.
byArtist.name Текст Обязательно — имя исполнителя/группы.
potentialAction ListenAction Обязательный параметр — объект разметки действия , содержащий подробную информацию о действии. См. свойства разметки действия для получения более подробной информации.
subjectOf Музыкальный плейлист Обязательно для действий, инициализируемых сущностью — Подробная информация о действии, инициализированном сущностью .
subjectOf.@type Текст Обязательно для действий, инициализируемых сущностью . Для этого свойства всегда устанавливайте значение MusicPlaylist .
subjectOf.@id URL Обязательный параметр для действий, инициализируемых сущностью — идентификатор действия, инициализированного сущностью. См. требования к @id выше. Он должен отличаться от @id альбома.
subjectOf.url URL Для действий, инициализируемых сущностью, требуется канонический URL-адрес этого действия. См. требования к url выше. Вы можете опустить этот параметр, если он совпадает с url альбома.
subjectOf.potentialAction ListenAction Для действий, инициализируемых сущностью, требуется объект разметки действия , предоставляющий подробную информацию о действии. См. свойства разметки действия для получения более подробной информации.
image ImageObject Изображение, представляющее музыкальный альбом. См. свойства разметки изображения .
sameAs URL URL-адрес веб-страницы, которая может идентифицировать альбом; например, страница альбома в Википедии. Этот адрес должен отличаться от свойства url .
numTracks Целое число The number of songs or tracks on this album.
timeRequired Текст The length of the album, in ISO 8601 format .
description Текст Краткое описание альбома. Ограничение: 300 символов.
isFamilyFriendly Логический Указывает, подходит ли данный контент для семейного просмотра (то есть, подходит ли он для всех членов семьи, включая детей). Продукты Google могут использовать isFamilyFriendly при определении песни для воспроизведения.
popularityScore PopularityScoreSpecification Показатель, который Google использует вместе с другими сигналами для определения того, какой контент воспроизводить пользователям. Этот показатель отражает популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала показателя должна быть одинаковой во всех ваших фидах, для всех объектов в вашем каталоге. По умолчанию показатель популярности объекта установлен на 0.
popularityScore.@type Текст Always set to PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), к которому(ым) применима данная оценка популярности. Если оценка популярности применима во всем мире, установите значение EARTH . По умолчанию это свойство имеет значение EARTH .

Запись музыки

Свойство Ожидаемый тип Описание
@context Текст Обязательно - Всегда устанавливайте значение ["http://schema.googleapis.com", {"@language": "xx"}] .
  • Где "xx" обозначает язык строк в потоке. Для каждого контекста корневой сущности параметр @language должен быть установлен на соответствующий код языка в формате BCP 47. Например, если язык установлен на испанский, предполагается, что имена будут на испанском, даже если язык субтитров/дубляжа — английский.
@type Текст Обязательно - для песен/треков всегда устанавливайте значение MusicRecording .
@id URL Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id must meet the following requirements:
  • Globally unique across your catalog
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство url объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой.
  • In the form of Unified Resource Identifier (URI)
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать url сущности в формате @id . Более подробную информацию см. в разделе «Идентификатор» .
url URL Обязательно — канонический URL-адрес контента, который Google использует для сопоставления контента в вашей ленте с контентом в базах данных Google.
url must meet the following requirements:
  • url must be globally unique
  • url должен содержать рабочий канонический URL, который Google может проиндексировать.
  • url должен указывать на страницу описания контента, не заблокированную платным доступом.
Для воспроизведения прямой ссылки используйте свойство urlTemplate целевого объекта.
name Текст Required - The name of the song.
byArtist Музыкальная группа Обязательно — укажите исполнителя или группу, записавшую эту песню. Как минимум, необходимо указать уникальный @id , используемый для этого исполнителя, и имя исполнителя. Если у песни несколько связанных исполнителей, вы можете указать массив значений в byArtist.
byArtist.@type Текст Обязательно — для этого свойства всегда устанавливайте значение MusicGroup .
byArtist.@id URL Обязательно — идентификатор исполнителя песни. См. требования к @id выше. Он должен совпадать с @id который вы используете для исполнителя/группы в других местах вашей ленты.
byArtist.name Текст Обязательно — имя исполнителя/группы.
potentialAction ListenAction Обязательный параметр — объект разметки действия , содержащий подробную информацию о действии. См. свойства разметки действия для получения более подробной информации.
subjectOf Музыкальный плейлист Обязательно для действий, инициализируемых сущностью — подробная информация о действии, инициализированном сущностью.
subjectOf.@type Текст Обязательно для действий, инициализируемых сущностью . Для этого свойства всегда устанавливайте значение MusicPlaylist .
subjectOf.@id URL Обязательный параметр для действий, инициализируемых сущностью : идентификатор действия, инициализированного сущностью. См. требования к @id выше. Он должен отличаться от @id для песни.
subjectOf.url URL Обязательно для действий, инициализируемых сущностью — канонический URL-адрес для такого действия. См. требования к url выше. Вы можете опустить этот параметр, если он совпадает с url песни.
subjectOf.potentialAction ListenAction Для действий, инициализируемых сущностью, требуется объект разметки действия , предоставляющий подробную информацию о действии. См. свойства разметки действия для получения более подробной информации.
image ImageObject Изображение, представляющее собой музыкальную запись. См. свойства разметки изображения .
sameAs URL URL-адрес веб-страницы, которая может идентифицировать альбом; например, страница альбома в Википедии. Этот адрес должен отличаться от свойства url .
inAlbum Музыкальный альбом The album on which the track appears, if any.
inAlbum.@type Текст Always set to MusicAlbum for this property.
inAlbum.@id URL Идентификатор альбома. См. требования к @id выше. Он должен совпадать с @id который вы используете для альбома в других местах вашей ленты.
inAlbum.name Текст The name of the album.
duration Текст The length of the song, in ISO 8601 format .
description Текст Краткое описание песни. Ограничение: 300 символов.
isFamilyFriendly Логический Указывает, подходит ли данный контент для семейного просмотра (то есть, подходит ли он для всех членов семьи, включая детей). Продукты Google могут использовать isFamilyFriendly при определении песни для воспроизведения.
popularityScore PopularityScoreSpecification Показатель, который Google использует вместе с другими сигналами для определения того, какой контент воспроизводить пользователям. Этот показатель отражает популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала показателя должна быть одинаковой во всех ваших фидах, для всех объектов в вашем каталоге. По умолчанию показатель популярности объекта установлен на 0.
popularityScore.@type Текст Always set to 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"
        }
      }
    }
  }
}

Для получения информации по соответствующим темам ознакомьтесь со следующими страницами: