Propiedades de lenguaje de marcado del contenido de las playlists de música

En esta sección, se proporcionan los detalles de las propiedades de marcado de contenido para el tipo de entidad MusicPlaylist.

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 MusicPlaylist para las combinaciones.
@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 playlist, por ejemplo, "Funky Jazz Mix".
genre Texto Obligatorio si la playlist es una combinación de géneros: Es una lista de palabras clave específicas del género que representa la playlist. La presencia de esta propiedad le indica a Google que deseas que esta playlist sea de género.
numTracks Número entero Obligatorio si la playlist es una selección de contenido: Es la cantidad de pistas de la playlist. La presencia de esta propiedad le indica a Google que esta playlist se seleccionó de forma manual. La ausencia de esta propiedad indicará que la playlist es infinita y generada automáticamente.
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.
image ImageObject Es una imagen de la playlist que representa la playlist o el mix de música. Consulta Propiedades de marcado de imágenes.
creator Organization o Person Se recomienda si el creador es de gran interés. Usa esta propiedad para indicar las playlists creadas por tu servicio (escritas como Organization con su propiedad name que indica tu servicio) o un usuario de alto interés de tu servicio (escrito como Person con su propiedad name que indica el usuario de interés).
keywords Texto Una lista de palabras clave ("rock", "pop"), estados de ánimo ("feliz", "malhumorado"), actividades ("ejercicio", "relajante") y otros términos relacionados con la playlist
description Texto Una breve descripción de la playlist. 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).

Ejemplo

Ejemplo que contiene una playlist seleccionada a mano de canciones pop de la década de 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."
}

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