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 lenguaje de marcado del contenido para el tipo de entidad MusicPlaylist.

Tabla de especificación

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 configurado con 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 o doblaje está en inglés.
@type Texto Obligatorio: Siempre se establece en MusicPlaylist para los mixes.
@id URL Obligatorio: El identificador del contenido en formato URI. por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Único a nivel global en todo tu catálogo
  • Estático; El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad de URL del programa). Se considerará como una cadena opaca que no necesariamente debe ser un vínculo activo.
  • Con el formato de un identificador de recursos unificado (URI)
  • El dominio para el valor @id debe ser propiedad de tu organización.
Debido a 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 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:
  • El campo 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 del contenido que no esté bloqueada por un muro de pago.
Para obtener información sobre el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto objetivo.
name Texto Obligatorio: Es el nombre de la playlist, por ejemplo, "Mix de jazz funk".
genre Texto Necesaria si la playlist es una combinación de géneros: Una lista de palabras clave específicas del género que representa la playlist. La presencia de esta propiedad le indica a Google que quieres que esta playlist sea de género.
numTracks Número entero Obligatorio si la playlist es una mezcla seleccionada: Número de pistas que contiene la playlist. La presencia de esta propiedad le indica a Google que esta playlist se seleccionó manualmente. La ausencia de esta propiedad indicará que la playlist es una playlist infinita generada automáticamente.
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.
image ImageObject Una imagen de playlist que representa la playlist o la mezcla de música. Consulta Propiedades de lenguaje de marcado de imágenes.
creator Organization o Person Se recomienda si el creador tiene mucho interés. Usa esta propiedad para indicar las playlists creadas por tu servicio (escrita como Organización y su propiedad name que indica el servicio) o por un usuario de tu servicio con un alto nivel de interés (escrita 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", "memoria"), actividades ("ejercicio", "relajación") o cualquier otro término relacionado con la playlist
description Texto Una breve descripción de la playlist. 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)

Ejemplo

Ejemplo con 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 obtener información sobre los temas relacionados con estas propiedades: