Ações de escuta propriedades comuns

Esta seção fornece os detalhes das propriedades comuns das ações de escuta.

Propriedades de marcação de ação

Propriedade Tipo esperado Descrição
potentialAction.@type Texto Obrigatório: sempre defina como ListenAction.
target EntryPoint Obrigatório: um objeto de destino que fornece o mapeamento de links diretos para várias plataformas do Google.
target.@type Texto Obrigatório: sempre defina como EntryPoint.
target.urlTemplate URL Obrigatório: é um link direto que leva os usuários ao seu app ou plataforma e inicia a reprodução do conteúdo.
target.actionPlatform Texto Obrigatório: as plataformas que são mapeadas para urlTemplate As ações de mídia oferecem suporte ao seguinte:
  • http://schema.org/DesktopWebPlatform: plataforma de pesquisa em navegadores da Web para computadores.
  • http://schema.org/MobileWebPlatform: plataforma de pesquisa em navegadores da Web para dispositivos móveis.
  • http://schema.org/AndroidPlatform: plataformas de Pesquisa e PlayGuide no app Android.
  • http://schema.org/AndroidTVPlatform: plataforma do Android TV no app Android TV.
  • http://schema.org/IOSPlatform: plataforma de pesquisa no app iOS.
  • http://schema.googleapis.com/GoogleVideoCast: plataformas Google Cast e Home em um dispositivo Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: plataformas Google Cast e Home em um dispositivo Chromecast (somente ações de áudio).
. Consulte a seção Tipos de plataforma para ver os requisitos.
expectsAcceptanceOf Oferta Obrigatório: um contêiner para o objeto da oferta.
expectsAcceptanceOf.@type Texto Obrigatório: sempre defina como Offer.
expectsAcceptanceOf.category Texto Obrigatório: um requisito de acesso ao conteúdo. Use uma das seguintes opções:
  • nologinrequired: o conteúdo não requer compra ou login.
  • free: o conteúdo exige que os usuários façam login e não tenha uma assinatura paga.
  • subscription: o conteúdo exige que os usuários façam login com uma assinatura.
expectsAcceptanceOf.availabilityStarts Data Data após a qual a ação estará disponível, no formato ISO 8601 (incluindo fuso horário). Pode ser uma data no futuro. Use essa propriedade para limitar a disponibilidade de ações por data/hora. Se não for incluído, presumiremos que a ação não tem limite de tempo.
expectsAcceptanceOf.availabilityEnds Data Data após a qual a ação não estará mais disponível, no formato ISO 8601 (incluindo fuso horário). Use essa propriedade para limitar a disponibilidade de ações por data/hora. Se não for incluído, presumiremos que a ação não tem limite de tempo.
expectsAcceptanceOf.eligibleRegion País Obrigatório: países onde a ação está disponível.
expectsAcceptanceOf.eligibleRegion.@type Texto Obrigatório: sempre defina como Country.
expectsAcceptanceOf.eligibleRegion.name Texto Obrigatório: os países onde a oferta é permitida. Especifique os países no formato ISO 3166.

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

Propriedades de marcação de imagem

Propriedade Tipo esperado Descrição
image.@type ImageObject Obrigatório: sempre defina como ImageObject.
contentUrl URL Obrigatório: o URL da imagem.
dateModified Data A data em que a imagem foi modificada/alterada mais recentemente, no formato ISO 8601 (incluindo o fuso horário)
regionsAllowed Place Os países onde a mídia é permitida. Especifique os países no formato ISO 3166.
  • Se não for especificado, será considerado que a imagem tem permissão para ser exibida em todas as localidades.
  • Para enviar imagens diferentes por região, adicione vários ImageObjects; cada um com o próprio conjunto de países e um URL de imagem correspondente.

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