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

Nesta seção, você verá 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 defina como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter o atributo @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda/dublado esteja em inglês.
@type Texto Obrigatório: sempre defina como MusicPlaylist para as combinações.
@id URL Obrigatório: o identificador de conteúdo no formato URI, por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em seu catálogo
  • Estático. O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade do URL do programa seja alterada. 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 organização.
Como a url da entidade atende a todos os requisitos como um identificador, recomendamos que você use o url da 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 nos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • O url precisa ser globalmente exclusivo
  • O url precisa conter um URL canônico que o Google possa rastrear.
  • O url precisa direcionar para uma página de descrição do conteúdo que não esteja bloqueada por um paywall.
Para link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório - O nome da playlist, por exemplo, "Funky Jazz Mix".
genre Texto Obrigatório se a playlist for uma combinação de gêneros: uma lista de palavras-chave específicas para o gênero que a playlist representa. A presença dessa propriedade indica ao Google que você quer que esta playlist seja de gênero.
numTracks Número inteiro Obrigatório se a playlist for um mix selecionado: o número de faixas na playlist. A presença dessa propriedade indica ao Google que esta playlist é selecionada manualmente. Se a propriedade não for exibida, isso significa que a playlist é gerada automaticamente de forma automática.
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 ver detalhes.
image ImageObject Uma imagem da playlist que representa a playlist ou o mix de música. Consulte Propriedades da marcação de imagens.
creator Organização ou Pessoa Recomendado se o criador de conteúdo tiver interesse. Use essa propriedade para indicar as playlists criadas pelo serviço (digitada como Organização com a propriedade name que indica seu serviço) ou um usuário de alto interesse do serviço (digitado como Pessoa 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 o conteúdo é adequado para todos os membros da família, incluindo crianças. Os produtos do Google podem usar isFamilyFriendly para determinar que uma música será tocada.
popularityScore Pontuação de popularidade Altamente recomendado por quê? Uma pontuação usada pelo Google e outros indicadores para determinar qual mídia tocar para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros no seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os feeds, 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 definir como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Uma pontuação mais alta significa maior popularidade.
popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for globalmente aplicável, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica da localidade tem precedência em relação à popularidade global (EARTH)

Exemplo

Exemplo que contém uma playlist selecionada manualmente de 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."
}

Consulte as seguintes páginas para os tópicos relacionados a essas propriedades: