Propiedades del lenguaje de marcado de contenido de listas de reproducción de música

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

Tabla de especificaciones

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se debe configurar como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Donde “&xx;xx” representa el idioma de las strings en el feed. El contexto de cada entidad raíz debe tener el @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, incluso si el idioma de los subtítulos está en inglés.
@type Texto Obligatorio: Siempre se debe establecer en MusicPlaylist para los mixes.
@id URL Obligatorio: el identificador de contenido en formato URI (por ejemplo, https://example.com/1234abc).
@id debe cumplir con los siguientes requisitos:
  • Único a nivel global en tu catálogo
  • Estático: el ID debe ser fijo y mantener el mismo formato (incluso si cambia la propiedad URL del programa). Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • En forma de identificador unificado de recursos (URI),
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que la url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses la url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
url URL Obligatorio: 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 dirigir a una página de descripción de 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 target en su lugar.
name Texto Obligatorio: el nombre de la lista de reproducción, por ejemplo, "Mix de jazz funk"
genre Texto Obligatorio si la lista de reproducción es una mezcla de géneros: una lista de palabras clave específicas del género que representa la lista de reproducción. La presencia de esta propiedad indica a Google que quieres que esta lista de reproducción sea de género.
numTracks Número entero Obligatorio si la lista de reproducción es una mezcla seleccionada: la cantidad de pistas en la lista de reproducción. La presencia de esta propiedad indica a Google que esta lista de reproducción está seleccionada manualmente. La ausencia de esta propiedad indicará que la lista de reproducción es infinita y generada automáticamente.
potentialAction ListenAction Obligatorio: 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 lenguaje de marcado de acciones.
image ImageObject Una imagen de lista de reproducción que representa la lista de reproducción o la mezcla de música. Consulta Propiedades del lenguaje 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 listas de reproducción creadas por tu servicio (escribidas como Organización, con la propiedad name que indica tu servicio) o como un usuario de tu servicio con gran interés (especificado como Persona, con la propiedad name que indica el usuario de interés).
keywords Texto Una lista de palabras clave (rock), pop (estado de ánimo), actividades (momento de felicidad), actividades (o ejercitarse) u otros términos relacionados con la lista de reproducción.
description Texto Una descripción breve de la lista de reproducció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 la familia, incluidos los niños). Los productos de Google pueden usar isFamilyFriendly para determinar una canción que se reproducirá.
popularityScore Puntuación de popularidad Recomendada ¿Por qué? Corresponde a una puntuación que utiliza Google, además de otros indicadores, para determinar qué medios reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con el resto del contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser la misma 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 establecer en PopularityScoreSpecification.
popularityScore.value Número 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 Regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad es aplicable a nivel global, configúrala como EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
Note: La popularidad específica de una configuración regional tiene prioridad sobre la popularidad global (EARTH)

Ejemplo

Ejemplo que contiene una lista de reproducción de canciones pop seleccionadas de la década del 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 obtener información sobre los temas relacionados con estas propiedades: