Propriedades de marcação de conteúdo de artistas, álbuns e músicas

Esta seção fornece os detalhes das propriedades de marcação de conteúdo para os tipos de entidade MusicGroup, MusicAlbum e MusicRecording.

Tabela de especificações

MusicGroup

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 definido como MusicGroup para artistas e grupos.
@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 do artista ou grupo.
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.
subjectOf MusicPlaylist Obrigatório para ações com dados de entidade: detalhes da ação com dados de entidade.
subjectOf.@type Texto Obrigatório para ações iniciadas por entidade: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações com dados de entidades: o identificador da ação com dados de entidades. Consulte os requisitos para @id acima. Ele precisa ser diferente do @id do artista/grupo.
subjectOf.url URL Obrigatório para ações com sementes de entidade: é o URL canônico da ação com sementes de entidade. Consulte os requisitos para url acima. Você pode omitir esse campo se ele for igual ao url do artista/grupo.
subjectOf.potentialAction ListenAction Obrigatório para ações iniciadas por entidade: 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 Imagem que representa o MusicGroup. Consulte Propriedades de marcação de imagem.
sameAs URL Um URL de uma página da Web de referência que possa identificar o artista, por exemplo, a página do artista na Wikipédia. Ele precisa ser diferente da propriedade url.
description Texto Uma breve biografia do artista. 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)

MusicAlbum

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 definido como MusicAlbum para álbuns.
@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 do álbum.
byArtist MusicGroup Obrigatório: o artista ou grupo que gravou o álbum. No mínimo, você precisa especificar o @id exclusivo que usa para esse artista e o nome dele. Se o álbum tiver vários artistas associados, você poderá fornecer uma matriz de valores em byArtist.
byArtist.@type Texto Obrigatório: sempre definido como MusicGroup para essa propriedade.
byArtist.@id URL Obrigatório: o identificador do artista do álbum. Consulte os requisitos para @id acima. Ele precisa corresponder ao @id usado para o artista/grupo em outro lugar do seu feed.
byArtist.name Texto Obrigatório: o nome do artista/grupo.
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.
subjectOf MusicPlaylist Obrigatório para ações com dados de entidade: detalhes da ação com dados de entidade.
subjectOf.@type Texto Obrigatório para ações iniciadas por entidade: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações com dados de entidades: o identificador da ação com dados de entidades. Consulte os requisitos para @id acima. Ele precisa ser diferente do @id do álbum.
subjectOf.url URL Obrigatório para ações com semente de entidade: o URL canônico da ação com semente de entidade. Consulte os requisitos para url acima. Você pode deixar isso de fora se ele for igual ao url do álbum.
subjectOf.potentialAction ListenAction Obrigatório para ações iniciadas por entidade: 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 Imagem que representa o álbum de música. Consulte Propriedades de marcação de imagem.
sameAs URL Um URL de uma página da Web de referência que pode identificar o álbum. Por exemplo, a página da Wikipédia do álbum. Ele precisa ser diferente da propriedade url.
numTracks Número inteiro O número de músicas ou faixas do álbum.
timeRequired Texto A duração do álbum, no formato ISO 8601.
description Texto Uma breve descrição do álbum. 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 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.

MusicRecording

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 definido como MusicRecording para músicas/faixas.
@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 música.
byArtist MusicGroup Obrigatório: o artista ou grupo que gravou a música. No mínimo, você precisa especificar o @id exclusivo que usa para esse artista e o nome dele. Se a música tiver vários artistas associados, forneça uma matriz de valores em byArtist.
byArtist.@type Texto Obrigatório: sempre definido como MusicGroup para essa propriedade.
byArtist.@id URL Obrigatório: o identificador do artista da música. Consulte os requisitos para @id acima. Ele precisa corresponder ao @id usado para o artista/grupo em outro lugar do seu feed.
byArtist.name Texto Obrigatório: o nome do artista/grupo.
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.
subjectOf MusicPlaylist Obrigatório para ações com dados de entidades: detalhes da ação com dados de entidade
subjectOf.@type Texto Obrigatório para ações iniciadas por entidade: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações com dados de entidades: o identificador da ação com dados de entidades. Consulte os requisitos para @id acima. Ele precisa ser diferente do @id da música.
subjectOf.url URL Obrigatório para ações com semente de entidade: o URL canônico da ação com semente de entidade. Consulte os requisitos para url acima. Você pode deixar isso de fora se for igual ao url da música.
subjectOf.potentialAction ListenAction Obrigatório para ações iniciadas por entidade: 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 Imagem que representa a gravação de música. Consulte Propriedades de marcação de imagem.
sameAs URL Um URL de uma página da Web de referência que pode identificar o álbum. Por exemplo, a página da Wikipédia do álbum. Ele precisa ser diferente da propriedade url.
inAlbum MusicAlbum O álbum em que a música aparece, se houver.
inAlbum.@type Texto Sempre defina como MusicAlbum para essa propriedade.
inAlbum.@id URL O identificador do álbum. Consulte os requisitos para @id acima. Ele precisa corresponder ao @id usado para o álbum em outro lugar do feed.
inAlbum.name Texto O nome do álbum.
duration Texto A duração da música, no formato ISO 8601.
description Texto Uma breve descrição da música. 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 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.

Exemplos

MusicGroup 

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicGroup",
  "@id":"http://www.example.com/artist/my_favorite_artist/",
  "url":"http://www.example.com/artist/my_favorite_artist/",
  "sameAs": "http://www.my_favorite_artist.com",
  "name":"My Favorite Artist",
  "description":"This is my favorite artist.",
  "image":[
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["US","UK","MX"]
    },
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/artist/my_favortie_artist/1x1/photo2.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["UA", "IR"]
    }
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 92,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "GB"
      }
    ]
  },
  "potentialAction": {
    "@type":"ListenAction",
    "target": {
      "@type":"EntryPoint",
      "urlTemplate":"http://www.example.com/artist/my_favorite_artist?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"
      ]
    },
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"subscription",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "subjectOf": {
    "@type":"MusicPlaylist",
    "@id":"http://www.example.com/artist_mix/my_favorite_artist/",
    "url":"http://www.example.com/artist_mix/my_favorite_artist/",
    "name":"My Favorite Artist Mix",
    "description":"A playlist of songs similar to My Favorite Artist",
    "potentialAction":{
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?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"
        ]
      },
      "expectsAcceptanceOf":{
        "@type":"Offer",
        "category":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"US"
        }
      }
    }
  }
}

MusicAlbum 

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicAlbum",
  "@id":"http://www.example.com/album/my_favorite_album",
  "url":"http://www.example.com/album/my_favorite_album",
  "name":"My Favorite Album",
  "sameAs":"https://en.wikipedia.org/wiki/my_favorite_album_(my_favorite_artist_album)",
  "description":"This is my favorite album.",
  "datePublished":"2010-08-24",
  "numTracks":"12",
  "timeRequired":"P44M02S",
  "byArtist":{
    "@type":"MusicGroup",
    "@id": "http://www.example.com/artist/my_favorite_artist/",
    "name":"My Favorite Artist"
  },
  "image":[
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo1.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["US","UK","MX"]
    },
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo2.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["UA", "IR"]
    }
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 87,
    "eligibleRegion": {
        "@type": "Country",
        "name": "US"
    }
  },
  "potentialAction": {
    "@type":"ListenAction",
    "target": {
      "@type":"EntryPoint",
      "urlTemplate":"http://www.example.com/album/my_favorite_album?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"
      ]
    },
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"subscription",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "subjectOf": {
    "@type":"MusicPlaylist",
    "@id":"http://www.example.com/album_mix/my_favorite_album",
    "url":"http://www.example.com/album_mix/my_favorite_album",
    "name":"My Favorite Album Mix",
    "description":"A playlist of songs similar to My Favorite Album",
    "potentialAction":{
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/album_mix/my_favorite_album?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"
        ]
      },
      "expectsAcceptanceOf":{
        "@type":"Offer",
        "category":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"US"
        }
      }
    }
  }
}

MusicRecording 

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicRecording",
  "@id":"http://www.example.com/track/my_favorite_song",
  "url":"http://www.example.com/track/my_favorite_song",
  "name":"My Favorite Song",
  "sameAs":"https://en.wikipedia.org/wiki/my_favorite_song_(song)",
  "description":"This is my favorite song.",
  "datePublished":"2010-08-24",
  "duration":"PT3M54S",
  "byArtist":{
    "@type":"MusicGroup",
    "@id": "http://www.example.com/artist/my_favorite_song/",
    "name":"My Favorite Artist"
  },
  "inAlbum":{
    "@type":"MusicAlbum",
    "@id":"http://www.example.com/album/my_favorite_album",
    "name":"My Favorite Album"
  },
  "image":[
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo1.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["US","UK","MX"]
    },
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo2.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["UA", "IR"]
    }
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 97,
    "eligibleRegion": "EARTH"
  },
  "potentialAction": {
    "@type":"ListenAction",
    "target": {
      "@type":"EntryPoint",
      "urlTemplate":"http://www.example.com/track/my_favorite_song?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"
      ]
    },
    "expectsAcceptanceOf": {
      "@type":"Offer",
      "category":"subscription",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "subjectOf": {
    "@type":"MusicPlaylist",
    "@id":"http://www.example.com/track_mix/my_favorite_song",
    "url":"http://www.example.com/track_mix/my_favorite_song",
    "name":"My Favorite Song Mix",
    "description":"A playlist of songs similar to My Favorite Song",
    "potentialAction":{
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/track_mix/my_favorite_song?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"
        ]
      },
      "expectsAcceptanceOf":{
        "@type":"Offer",
        "category":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"US"
        }
      }
    }
  }
}

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