Propriedades de marcação de conteúdo de filmes

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

Tabela de especificações

Propriedade Tipo esperado Descrição
@context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
  • Onde" xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com 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 o idioma da legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre defina como Movie para filmes.
@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.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório: o nome do filme.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo Várias regiões e idiomas.
  • Apenas um nome é aceito por localidade (par de idioma e país).
titleEIDR Texto Altamente recomendado Por quê? - Um identificador EIDR que representa, no nível mais geral/abstrato, uma obra de filme ou televisão.

Por exemplo, o título EIDR do filme "Os Caça-Fantasmas" é "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Texto Altamente recomendado Por quê? - Um identificador EIDR (em inglês) que representa uma edição / edição específica de um filme ou uma obra de televisão.

Por exemplo, o filme "Os Caça-Fantasmas" com o título EIDR como "10.5240/7EC7-228A-510A-053E-CBB8-J", tem várias edições. Por exemplo: "10.5240/1F2A-E1C5-680A-14C6-E76B-I" e "10.5240/8A35-3BEE-6497-5D12-9E4F-3". A propriedade

titleEIDR é obrigatória quando o EIDR da edição é fornecido.
potentialAction WatchAction Obrigatório, se aplicável: um objeto de marcação de ação que fornece os detalhes da ação.
  • Se o conteúdo estiver disponível em vídeo on demand (VoD), essa propriedade será obrigatória. O objeto de marcação "Action" precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal de LiveTV, essa propriedade será opcional. a entidade BroadcastService associada fornece o link direto do canal;
  • Um Movie pode estar disponível em VoD e LiveTV.
Use uma matriz para especificar diferentes links diretos em várias regiões. Veja o exemplo Várias regiões e idiomas.
sameAs URL Altamente recomendado Por quê? Um URL para uma página da web de referência que possa identificar o filme; por exemplo, a página do filme na Wikipédia. Ela precisa ser diferente da propriedade url.
inLanguage Texto Idioma original do filme no formato BCP 47.
genre Texto Uma lista ordenada de todos os gêneros relevantes. Por exemplo : ["Ação", "Moda", "Ambiente", "Futebol"]
keywords Texto Palavras-chave ou tags usadas para descrever esse conteúdo. Também é permitido usar uma matriz de palavras-chave. Por exemplo, ["feature, biography"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Altamente recomendado Por quê? - Um PublicationEvent é usado para especificar o lançamento original (global ou local) do conteúdo por um editor, como a data de lançamento original no cinema de um filme.

Além disso, use FeaturedEvent para indicar que seu serviço comercializa esse conteúdo como original, em destaque, especial e assim por diante.

ExclusiveEvent especifica que seu serviço tem direitos de distribuição exclusivos e inclui onde e quando.

Consulte a seção de exemplo para detalhes e exemplos.
releasedEvent.@type Texto Obrigatório – Sempre defina essa propriedade como uma das seguintes opções:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obrigatório: as regiões associadas a este evento.

Para uma PublicationEvent, é a região onde o conteúdo foi publicado.

Para FeaturedEvent e ExclusiveEvent, é a região onde o conteúdo é apresentado ou exclusivo.

Use os códigos ISO 3166 para os países. Para indicar todos os lugares do mundo, defina como EARTH.
releasedEvent.startDate Date ou DateTime Recomendado - Obrigatório para ExclusiveEvent: a data de início da publicação da entidade.

Para PublicationEvent, isso indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado nos cinemas.

Para ExclusiveEvent e FeaturedEvent, representa a data de início em que a entidade é exclusiva ou exibida em destaque.
releasedEvent.endDate Date ou DateTime RecomendadoObrigatório para ExclusiveEvent: aplicável apenas aos tipos ExclusiveEvent e FeaturedEvent.

Para ExclusiveEvent, isso representa a data em que os direitos sobre o conteúdo expiram.

Para FeaturedEvent, representa a última data em que o provedor apresenta a entidade.

Se o conteúdo for permanentemente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organização ou Pessoa Opcional: a organização ou pessoa que publicou a entidade.
description Texto Altamente recomendado Por quê? uma sinopse do filme. Sinopses do enredo são preferidas em vez de resumos factuais. Limite de 300 caracteres.
duration Duração Tempo de execução do filme no formato ISO 8601. Use o formato: "PT00H00M".
director Person Altamente recomendado Por quê? Os diretores do filme.
actor Person Altamente recomendado Por quê? Os membros do elenco do filme.
producer Organização ou Pessoa Altamente recomendado Por quê? Os produtores do filme.
image ImageObject Obrigatório para Google TV: são as imagens relacionadas ao filme. Para mais detalhes sobre as propriedades obrigatórias e opcionais a serem incluídas com image, consulte Propriedades de imagem.
trailer.description Texto A descrição do trailer. Veja o exemplo do Trailer.
trailer.inLanguage Texto O idioma do trailer no formato BCP 47.
trailer.url URL Um URL de um trailer hospedado publicamente e enviado pelos respectivos estúdios de produção ou fontes autorizadas.
trailer.regionsAllowed Place As regiões em que a mídia é permitida. Se não for especificado, ele será considerado permitido em todos os lugares. Especifique os países no formato ISO 3166.
identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica claramente essa entidade. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
review Review (em inglês) Avaliar classificações do Filme
review.reviewRating Classificação Obrigatório se a avaliação for fornecida. É usado para especificar a classificação dada na avaliação.
contentRating Text ou Rating Obrigatório para conteúdo adulto, mas altamente recomendado. Caso contrário, Por quê? - Classificação geral do conteúdo. Se a classificação do conteúdo for dada na forma de uma string de texto, duas variações serão aceitas:
  • A agência precedida pela classificação com um espaço em branco no meio. Por exemplo, "PG-13" classificação da agência "MPAA" nos EUA deve ser descrita como "MPAA PG-13". Consulte a lista de agências.
  • Um valor de "CLASSIFICAÇÃO NÃO CONHECIDA" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do Filme.
contentRating.author Organização Obrigatório se contentRating usar Rating: é o nome da agência de classificação.
contentRating.ratingValue Texto Obrigatório se contentRating usar Rating: o valor da classificação.
contentRating.advisoryCode Texto O código consultivo do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência fantasiosa, L = idioma, S = conteúdo sexual, V = violência.
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)
category Texto Obrigatório, se aplicável: preencha essa propriedade se a entidade for uma variante Movie. Defina category como uma das seguintes opções:
  • Home Release: uma versão vendida ou alugada para visualização em casa.
  • Theatrical Release: uma versão lançada nos cinemas.
  • International Release: uma versão editada para lançamento internacional.
  • Remastered: uma versão em que as imagens, os sons ou ambos foram aprimorados para um padrão mais atualizado.
  • Unrated: uma versão que não é filtrada pela MPAA ou por uma agência semelhante.
  • Director Cut: uma versão que representa a edição aprovada do diretor.
  • Extended Cut: uma versão mais longa do que o lançamento no cinema.
workExample Filme Especifica as variantes do filme. Inclua essa propriedade na entidade Movie principal, não nas entidades Movie das versões da variante.
workExample.@id URL Para variantes Movie, essa propriedade fornece o @id da entidade Movie de que ela é uma variante.
workExample.@type Texto Obrigatório: sempre defina como Movie. Isso pode ser representado como uma matriz para uma Movie com diversas variantes.
workExample.@id URL Obrigatório: o @id da variante Movie.
workExample.name Texto Obrigatório: é o nome da variante Movie.
workExample.category Texto Obrigatório: o tipo de variante do filme de uma versão específica. Defina a categoria como uma das seguintes opções:
  • Home Release: uma versão vendida ou alugada para visualização em casa.
  • Theatrical Release: uma versão lançada nos cinemas.
  • International Release: uma versão editada para lançamento internacional.
  • Remastered: uma versão em que as imagens, os sons ou ambos foram aprimorados para um padrão mais atualizado.
  • Unrated: uma versão que não é filtrada pela MPAA ou por uma agência semelhante.
  • Director Cut: uma versão que representa a edição aprovada do diretor.
  • Extended Cut: uma versão mais longa do que o lançamento no cinema.

Exemplo

Filme principal

Um filme com uma variante de corte estendido.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

Variante de corte estendido

É a versão estendida do filme principal.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}

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