Propriedades de marcação de conteúdo de playlists de música

Esta seção fornece os detalhes das propriedades de marcação de conteúdo para o tipo de entidade MusicPlaylist.

Tabela de especificações

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que a legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre defina como MusicPlaylist para mixagens.
@id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo
  • Estáticas: o ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • No formato de identificador de recurso unificado (URI)
  • O domínio usado para o valor @id precisa ser de propriedade da sua organização.
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url de uma entidade como @id. Consulte a seção Identificador para mais detalhes.
url URL Obrigatório: o URL canônico do conteúdo, que o Google usa para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • O url precisa conter um URL canônico que funcione e que o Google possa rastrear.
  • O url precisa apontar para uma página de descrição de conteúdo que não seja bloqueada por um paywall.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto alvo.
name Texto Obrigatório: o nome da playlist, por exemplo, "Funky Jazz Mix".
genre Texto Obrigatório se a playlist for um gênero misto: uma lista de palavras-chave específicas do gênero que a playlist representa. A presença dessa propriedade indica ao Google que você pretende que essa playlist seja de gênero.
numTracks Número inteiro Obrigatório se a playlist for uma seleção personalizada: o número de faixas na playlist. A presença dessa propriedade indica ao Google que a playlist é selecionada manualmente. A ausência dessa propriedade indica que a playlist é uma playlist gerada automaticamente e infinita.
potentialAction ListenAction Obrigatório: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as Propriedades da marcação de ação para mais detalhes.
image ImageObject Uma imagem que representa a playlist ou o mix de músicas. Consulte Propriedades de marcação de imagem.
creator Organization ou Person Recomendado se o criador de conteúdo for de grande interesse. Use essa propriedade para indicar as playlists criadas pelo seu serviço (digitadas como Organization com a propriedade name indicando seu serviço) ou um usuário de alto interesse do seu serviço (digitado como Person com a propriedade name indicando o usuário de interesse).
keywords Texto Uma lista de palavras-chave ("rock", "pop"), humores ("happy", "moody"), atividades ("exercise", "relaxing") ou outros termos relacionados à playlist.
description Texto Uma breve descrição da playlist. Limite de 300 caracteres.
isFamilyFriendly Booleano Indica se o conteúdo é adequado para toda a família, ou seja, se é adequado para todos os membros da família, incluindo crianças. Os produtos do Google podem usar isFamilyFriendly ao determinar uma música para tocar.
popularityScore PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia será reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
popularityScore.@type Texto Sempre defina como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Quanto maior a pontuação, maior a popularidade.
popularityScore.eligibleRegion País Regiões em que esse índice de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica da localidade tem precedência sobre a global (EARTH)

Exemplo

Exemplo que contém uma playlist selecionada manualmente das músicas pop dos anos 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."
}

Confira as páginas a seguir para ver os tópicos relacionados a essas propriedades: