Propiedades de marcado del contenido de artistas, álbumes y canciones

En esta sección, se proporcionan los detalles de las propiedades de lenguaje de marcado del contenido para los tipos de entidades MusicGroup, MusicAlbum y MusicRecording.

Tabla de especificaciones

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.googleapis.com", {"@language": "xx"}].
  • Donde "xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es inglés.
@type Texto Obligatorio: Siempre se establece en MusicGroup para artistas y grupos.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en tu catálogo.
  • Estático: El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el 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 detalles.
url URL Obligatorio: Es 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:
  • url debe ser único a nivel global
  • url debe contener una URL canónica que funcione y que Google pueda rastrear.
  • url debe apuntar a una página de descripción del contenido que no esté bloqueada por un muro de pago.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
name Texto Obligatorio: Es el nombre del artista o grupo.
potentialAction ListenAction Obligatorio: Es un objeto de marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
subjectOf MusicPlaylist Obligatorio para las acciones con entidades precargadas: Detalles de la acción con entidades precargadas.
subjectOf.@type Texto Obligatorio para las acciones propagadas por entidades: Siempre se establece en MusicPlaylist para esta propiedad.
subjectOf.@id URL Obligatorio para las acciones propagadas por entidades: Es el identificador de la acción propagada por entidades. Consulta los requisitos de @id más arriba. Debe ser distinto del @id del artista o grupo.
subjectOf.url URL Obligatorio para las acciones propagadas por entidades: Es la URL canónica de la acción propagada por entidades. Consulta los requisitos de url más arriba. Puedes omitir este campo si es igual al url del artista o grupo.
subjectOf.potentialAction ListenAction Obligatorio para las acciones propagadas por entidades: Es un objeto de marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
image ImageObject Es la imagen que representa el MusicGroup. Consulta Propiedades de marcado de imágenes.
sameAs URL Es una URL a una página web de referencia que puede identificar al artista; por ejemplo, la página de Wikipedia del artista. Debe ser diferente de la propiedad url.
description Texto Una breve biografía del artista. Tiene un límite de 300 caracteres.
isFamilyFriendly Booleano Indica si el contenido es apto para familias (es decir, si es adecuado para todos los miembros de una familia, incluidos los niños). Es posible que los productos de Google usen isFamilyFriendly cuando determinen una canción para reproducir.
popularityScore PopularityScoreSpecification Muy recomendable ¿Por qué? Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con el resto del catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre 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 indica 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 aplica a nivel global, configúrala como 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).
Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.googleapis.com", {"@language": "xx"}].
  • Donde "xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es inglés.
@type Texto Obligatorio: Siempre se debe establecer como MusicAlbum para los álbumes.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en tu catálogo.
  • Estático: El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el 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 detalles.
url URL Obligatorio: Es 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:
  • url debe ser único a nivel global
  • url debe contener una URL canónica que funcione y que Google pueda rastrear.
  • url debe apuntar a una página de descripción del contenido que no esté bloqueada por un muro de pago.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
name Texto Obligatorio: Es el nombre del álbum.
byArtist MusicGroup Obligatorio: Es 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 un array 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 del feed.
byArtist.name Texto Obligatorio: Es el nombre del artista o grupo.
potentialAction ListenAction Obligatorio: Es un objeto de marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
subjectOf MusicPlaylist Obligatorio para las acciones propagadas por entidades: Detalles de la acción propagada por entidades.
subjectOf.@type Texto Obligatorio para las acciones propagadas por entidades: Siempre se establece en MusicPlaylist para esta propiedad.
subjectOf.@id URL Obligatorio para las acciones propagadas por entidades: Es el identificador de la acción propagada por entidades. Consulta los requisitos de @id más arriba. Debe ser distinto del @id del álbum.
subjectOf.url URL Obligatorio para las acciones propagadas por entidades: Es la URL canónica de la acción propagada por entidades. Consulta los requisitos de url más arriba. Puedes omitir este campo si es igual que el url del álbum.
subjectOf.potentialAction ListenAction Obligatorio para las acciones propagadas por entidades: Es un objeto de marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
image ImageObject Es la imagen que representa el MusicAlbum. Consulta Propiedades de marcado de imágenes.
sameAs URL Es la URL de una página web de referencia que puede identificar el álbum, por ejemplo, la página de Wikipedia del álbum. Debe ser diferente de la propiedad url.
numTracks Número entero Es la cantidad de canciones o pistas de este álbum.
timeRequired Texto Es la duración del álbum, en formato ISO 8601.
description Texto Es una breve descripción del álbum. Tiene un límite de 300 caracteres.
isFamilyFriendly Booleano Indica si el contenido es apto para familias (es decir, si es adecuado para todos los miembros de una familia, incluidos los niños). Es posible que los productos de Google usen isFamilyFriendly cuando determinen una canción para reproducir.
popularityScore PopularityScoreSpecification Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con el resto del catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre 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 indica 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 aplica a nivel global, configúrala como EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.googleapis.com", {"@language": "xx"}].
  • Donde "xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es inglés.
@type Texto Obligatorio: Siempre se establece en MusicRecording para las canciones o pistas.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en tu catálogo.
  • Estático: El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el 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 detalles.
url URL Obligatorio: Es 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:
  • url debe ser único a nivel global
  • url debe contener una URL canónica que funcione y que Google pueda rastrear.
  • url debe apuntar a una página de descripción del contenido que no esté bloqueada por un muro de pago.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
name Texto Obligatorio: Es el nombre de la canción.
byArtist MusicGroup Obligatorio: Es el artista o el 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 un array 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 del feed.
byArtist.name Texto Obligatorio: Es el nombre del artista o grupo.
potentialAction ListenAction Obligatorio: Es un objeto de marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
subjectOf MusicPlaylist Obligatorio para las acciones con entidades precargadas: Detalles de la acción con entidades precargadas
subjectOf.@type Texto Obligatorio para las acciones propagadas por entidades: Siempre se establece en MusicPlaylist para esta propiedad.
subjectOf.@id URL Obligatorio para las acciones propagadas por entidades: Es el identificador de la acción propagada por entidades. Consulta los requisitos de @id más arriba. Debe ser distinto del @id de la canción.
subjectOf.url URL Obligatorio para las acciones propagadas por entidades: Es la URL canónica de la acción propagada por entidades. Consulta los requisitos de url más arriba. Puedes omitir este campo si es igual al url de la canción.
subjectOf.potentialAction ListenAction Obligatorio para las acciones propagadas por entidades: Es un objeto de marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
image ImageObject Es una imagen que representa la MusicRecording. Consulta Propiedades de marcado de imágenes.
sameAs URL Es la URL de una página web de referencia que puede identificar el álbum, por ejemplo, la página de Wikipedia del álbum. Debe ser diferente 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 de tu feed.
inAlbum.name Texto El nombre del álbum.
duration Texto Es la duración de la canción, en formato ISO 8601.
description Texto Es una breve descripción de la canción. Tiene un límite de 300 caracteres.
isFamilyFriendly Booleano Indica si el contenido es apto para familias (es decir, si es adecuado para todos los miembros de una familia, incluidos los niños). Es posible que los productos de Google usen isFamilyFriendly cuando determinen una canción para reproducir.
popularityScore PopularityScoreSpecification Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con el resto del catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre 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 indica 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 aplica a nivel global, configúrala como EARTH. De forma predeterminada, esta propiedad se establece en EARTH.

Ejemplos

{
  "@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"
        }
      }
    }
  }
}

Consulta las siguientes páginas para ver los temas relacionados con estas propiedades: