En esta sección, se proporcionan los detalles de las propiedades de lenguaje de marcado del contenido para los tipos de entidad MusicGroup
, MusicAlbum
y MusicRecording
.
Tabla de especificación
MusicGroup
Propiedad | Tipo esperado | Descripción |
---|---|---|
@context |
Texto | Obligatorio: Siempre se establece en ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
Texto | Obligatorio: Siempre se establece en MusicGroup para artistas y grupos. |
@id |
URL | Obligatorio: El identificador del contenido en formato URI. por ejemplo, https://example.com/1234abc.@id debe cumplir con los siguientes requisitos:
url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id . Consulta la sección Identificador para obtener más información. |
url |
URL | Obligatoria: La URL canónica del contenido, que Google usa para hacer coincidir el contenido de tu feed con el contenido de las bases de datos de Google.url debe cumplir con los siguientes requisitos:
urlTemplate del objeto objetivo. |
name |
Texto | Obligatorio: El nombre del artista o grupo.
|
potentialAction |
ListenAction | Obligatorio: Un objeto de lenguaje de marcado de acciones que proporciona los detalles de la acción. Para obtener más información, consulta las propiedades de marcado de acciones.
|
subjectOf |
MusicPlaylist | Obligatorio para las acciones de origen de entidades: Son los detalles de la acción de origen de entidad. |
subjectOf.@type |
Texto | Obligatorio para las acciones de origen de la entidad: Siempre debes establecerlo en MusicPlaylist para esta propiedad. |
subjectOf.@id |
URL | Obligatorio para las acciones de origen de entidades: Es el identificador de la acción de origen de la entidad. Consulta los requisitos de @id más arriba. Debe ser distinto de @id del artista o grupo. |
subjectOf.url |
URL | Obligatorio para las acciones de origen de la entidad: Es la URL canónica de la acción de origen de la entidad. Consulta los requisitos de url más arriba. Puedes omitir este paso si es igual a url para el artista o grupo. |
subjectOf.potentialAction |
ListenAction | Obligatorio para las acciones de origen de entidades: Es un objeto de lenguaje de marcado de acciones que proporciona los detalles de la acción. Para obtener más información, consulta las propiedades de marcado de acciones.
|
image |
ImageObject | Imagen que representa a MusicGroup. Consulta Propiedades de lenguaje de marcado de imágenes. |
sameAs |
URL | una URL a una página web de referencia que pueda identificar al artista; por ejemplo, la página de Wikipedia del artista. Debe ser distinto de la propiedad url . |
description |
Texto | Una breve biografía del artista. Límite de 300 caracteres.
|
isFamilyFriendly |
Booleano | Indica si este contenido es apto para familias (es decir, si es apto para todos los miembros de una familia, incluidos los niños). Los productos de Google pueden usar isFamilyFriendly para determinar la canción que se reproducirá. |
popularityScore |
PopularityScoreSpecification | altamente recomendado ¿Por qué? Es una puntuación que Google utiliza, junto con otros indicadores, para determinar qué contenido multimedia se debe reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y en todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0. |
popularityScore.@type |
Texto | Siempre se establece en PopularityScoreSpecification . |
popularityScore.value |
Número | Es un valor numérico no negativo que indica la popularidad de la entidad. una puntuación más alta significa una mayor popularidad. |
popularityScore.eligibleRegion |
País | Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se puede aplicar a nivel global, establécela en EARTH . De forma predeterminada, esta propiedad se establece en EARTH . Note: La popularidad específica de la configuración regional tiene prioridad sobre la popularidad global (EARTH) |
MusicAlbum
Propiedad | Tipo esperado | Descripción |
---|---|---|
@context |
Texto | Obligatorio: Siempre se establece en ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
Texto | Obligatorio: Siempre se establece en MusicAlbum para los álbumes. |
@id |
URL | Obligatorio: El identificador del contenido en formato URI. por ejemplo, https://example.com/1234abc.@id debe cumplir con los siguientes requisitos:
url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id . Consulta la sección Identificador para obtener más información. |
url |
URL | Obligatoria: La URL canónica del contenido, que Google usa para hacer coincidir el contenido de tu feed con el contenido de las bases de datos de Google.url debe cumplir con los siguientes requisitos:
urlTemplate del objeto objetivo. |
name |
Texto | Obligatorio: El nombre del álbum.
|
byArtist |
MusicGroup | Obligatorio: El artista o grupo que grabó este álbum. Como mínimo, debes especificar el @id único que usas para ese artista y su nombre. Si el álbum tiene varios artistas asociados, puedes proporcionar una matriz de valores en byArtist. |
byArtist.@type |
Texto | Obligatorio: Siempre se establece en MusicGroup para esta propiedad. |
byArtist.@id |
URL | Obligatorio: Es el identificador del artista del álbum. Consulta los requisitos de @id más arriba. Debe coincidir con el @id que usas para el artista o el grupo en otra parte de tu feed. |
byArtist.name |
Texto | Obligatorio: Es el nombre del artista o grupo. |
potentialAction |
ListenAction | Obligatorio: Un objeto de lenguaje de marcado de acciones que proporciona los detalles de la acción. Para obtener más información, consulta las propiedades de marcado de acciones.
|
subjectOf |
MusicPlaylist | Obligatorio para las acciones de origen de entidades: Son los detalles de la acción de origen de entidad. |
subjectOf.@type |
Texto | Obligatorio para las acciones de origen de la entidad: Siempre debes establecerlo en MusicPlaylist para esta propiedad. |
subjectOf.@id |
URL | Obligatorio para las acciones de origen de entidades: Es el identificador de la acción de origen de la entidad. Consulta los requisitos de @id más arriba. Debe ser distinto del @id del álbum. |
subjectOf.url |
URL | Obligatorio para las acciones de origen de la entidad: Es la URL canónica de la acción de origen de la entidad. Consulta los requisitos de url más arriba. Puedes omitir este paso si es el mismo que el url del álbum. |
subjectOf.potentialAction |
ListenAction | Obligatorio para las acciones de origen de entidades: Es un objeto de lenguaje de marcado de acciones que proporciona los detalles de la acción. Para obtener más información, consulta las propiedades de marcado de acciones.
|
image |
ImageObject | Imagen que representa el MusicAlbum. Consulta Propiedades de lenguaje de marcado de imágenes. |
sameAs |
URL | Una URL a una página web de referencia que pueda identificar el álbum por ejemplo, la página de Wikipedia del álbum. Debe ser distinto de la propiedad url . |
numTracks |
Número entero | La cantidad de canciones o pistas de este álbum. |
timeRequired |
Texto | La duración del álbum en formato ISO 8601. |
description |
Texto | Una breve descripción del álbum. Límite de 300 caracteres.
|
isFamilyFriendly |
Booleano | Indica si este contenido es apto para familias (es decir, si es apto para todos los miembros de una familia, incluidos los niños). Los productos de Google pueden usar isFamilyFriendly para determinar la canción que se reproducirá. |
popularityScore |
PopularityScoreSpecification | Es una puntuación que Google utiliza, junto con otros indicadores, para determinar qué contenido multimedia se debe reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y en todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0. |
popularityScore.@type |
Texto | Siempre se establece en PopularityScoreSpecification . |
popularityScore.value |
Número | Es un valor numérico no negativo que indica la popularidad de la entidad. una puntuación más alta significa una mayor popularidad. |
popularityScore.eligibleRegion |
País | Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se puede aplicar a nivel global, establécela en EARTH . De forma predeterminada, esta propiedad se establece en EARTH . |
MusicRecording
Propiedad | Tipo esperado | Descripción |
---|---|---|
@context |
Texto | Obligatorio: Siempre se establece en ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
Texto | Obligatorio: Siempre se establece en MusicRecording para las canciones o pistas. |
@id |
URL | Obligatorio: El identificador del contenido en formato URI. por ejemplo, https://example.com/1234abc.@id debe cumplir con los siguientes requisitos:
url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id . Consulta la sección Identificador para obtener más información. |
url |
URL | Obligatoria: La URL canónica del contenido, que Google usa para hacer coincidir el contenido de tu feed con el contenido de las bases de datos de Google.url debe cumplir con los siguientes requisitos:
urlTemplate del objeto objetivo. |
name |
Texto | Obligatorio: El nombre de la canción.
|
byArtist |
MusicGroup | Obligatorio: El artista o grupo que grabó esta canción. Como mínimo, debes especificar el @id único que usas para ese artista y su nombre. Si la canción tiene varios artistas asociados, puedes proporcionar una matriz de valores en byArtist. |
byArtist.@type |
Texto | Obligatorio: Siempre se establece en MusicGroup para esta propiedad. |
byArtist.@id |
URL | Obligatorio: Es el identificador del artista de la canción. Consulta los requisitos de @id más arriba. Debe coincidir con el @id que usas para el artista o el grupo en otra parte de tu feed. |
byArtist.name |
Texto | Obligatorio: Es el nombre del artista o grupo. |
potentialAction |
ListenAction | Obligatorio: Un objeto de lenguaje de marcado de acciones que proporciona los detalles de la acción. Para obtener más información, consulta las propiedades de marcado de acciones.
|
subjectOf |
MusicPlaylist | Obligatorio para las acciones de origen de la entidad: Detalles de la acción de origen de la entidad |
subjectOf.@type |
Texto | Obligatorio para las acciones de origen de la entidad: Siempre debes establecerlo en MusicPlaylist para esta propiedad. |
subjectOf.@id |
URL | Obligatorio para las acciones de origen de entidades: Es el identificador de la acción de origen de la entidad. Consulta los requisitos de @id más arriba. Debe ser distinto del @id de la canción. |
subjectOf.url |
URL | Obligatorio para las acciones de origen de la entidad: Es la URL canónica de la acción de origen de la entidad. Consulta los requisitos de url más arriba. Puedes omitir este paso si es el mismo que el url de la canción. |
subjectOf.potentialAction |
ListenAction | Obligatorio para las acciones de origen de entidades: Es un objeto de lenguaje de marcado de acciones que proporciona los detalles de la acción. Para obtener más información, consulta las propiedades de marcado de acciones.
|
image |
ImageObject | Imagen que representa MusicRecording. Consulta Propiedades de lenguaje de marcado de imágenes. |
sameAs |
URL | Una URL a una página web de referencia que pueda identificar el álbum por ejemplo, la página de Wikipedia del álbum. Debe ser distinto de la propiedad url . |
inAlbum |
MusicAlbum | El álbum en el que aparece la pista, si corresponde. |
inAlbum.@type |
Texto | Siempre se establece en MusicAlbum para esta propiedad. |
inAlbum.@id |
URL | Es el identificador del álbum. Consulta los requisitos de @id más arriba. Debe coincidir con el @id que usas para el álbum en otra parte del feed. |
inAlbum.name |
Texto | El nombre del álbum. |
duration |
Texto | Es la duración de la canción en formato ISO 8601. |
description |
Texto | Una breve descripción de la canción. Límite de 300 caracteres.
|
isFamilyFriendly |
Booleano | Indica si este contenido es apto para familias (es decir, si es apto para todos los miembros de una familia, incluidos los niños). Los productos de Google pueden usar isFamilyFriendly para determinar la canción que se reproducirá. |
popularityScore |
PopularityScoreSpecification | Es una puntuación que Google utiliza, junto con otros indicadores, para determinar qué contenido multimedia se debe reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y en todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0. |
popularityScore.@type |
Texto | Siempre se establece en PopularityScoreSpecification . |
popularityScore.value |
Número | Es un valor numérico no negativo que indica la popularidad de la entidad. una puntuación más alta significa una mayor popularidad. |
popularityScore.eligibleRegion |
País | Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se puede aplicar a nivel global, establécela en EARTH . De forma predeterminada, esta propiedad se establece en EARTH . |
Ejemplos
MusicGroup
{
"@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"
}
}
}
}
}
MusicAlbum
{
"@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"
}
}
}
}
}
MusicRecording
{
"@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"
}
}
}
}
}
Páginas relacionadas
Consulta las siguientes páginas para obtener información sobre los temas relacionados con estas propiedades: