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 defina como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre defina como MusicPlaylist para mixes.
@id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo
  • Estático 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 em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela 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 corresponder o conteúdo do seu feed ao conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico em funcionamento que possa ser rastreado pelo Google.
  • O url precisa direcionar para uma página de descrição do conteúdo que não seja bloqueada por um paywall.
Para o 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 do gênero que a playlist representa. A presença dessa propriedade indica ao Google que você quer que essa playlist seja de gênero.
numTracks Número inteiro Obrigatório se a playlist for um mix selecionado: é o número de faixas da playlist. A presença dessa propriedade indica ao Google que essa playlist foi selecionada manualmente. A ausência dessa propriedade indica que a playlist é uma lista infinita gerada automaticamente.
potentialAction ListenAction Obrigatório: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as propriedades de marcação de ação para mais detalhes.
image ImageObject Uma imagem de playlist que representa a playlist ou o mix de músicas. Consulte Propriedades de marcação de imagem.
creator Organização ou Pessoa Recomendado se o criador de conteúdo tiver grande interesse. Use essa propriedade para indicar as playlists criadas pelo seu serviço (digitadas como Organização, com a propriedade name indicando seu serviço) ou um usuário de alto interesse no seu serviço (digitado como Pessoa com a propriedade name indicando o usuário de interesse).
keywords Texto Uma lista de palavras-chave ("rock", "pop"), humor ("feliz", "mal-humorado"), atividades ("exercício", "relaxante") 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, é adequado para todos os membros de uma 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 vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no 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. 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 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 popularidade global (EARTH)

Exemplo

Exemplo que contém uma playlist selecionada manualmente com 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 os tópicos relacionados a essas propriedades: