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

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

Tabela de especificação

Propriedade	Tipo esperado	Descrição
`@context`	Texto	Obrigatório: sempre definido como `["http://schema.org", {"@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 o idioma da legenda/dublagem seja inglês.
`@type`	Texto	Obrigatório: sempre definido 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 em todo o catálogo Estático. O ID precisa ser estável e não pode mudar com o tempo, mesmo que a propriedade "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 corresponder o conteúdo do seu feed com o 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 funcional que o Google possa rastrear. Para o link direto de reprodução, consulte a propriedade `urlTemplate` do objeto target.
`name`	Texto	Obrigatório: o nome do filme. Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo Várias regiões e idiomas. Só é possível usar um nome por localidade (par idioma-país).
`titleEIDR`	Texto	Altamente recomendável Por quê? - Um identificador EIDR (Entertainment Identifier Registry) que representa, no nível mais geral/abstrato, uma obra de cinema ou televisão. Por exemplo, o EIDR do título do filme "Os Caça-Fantasmas" é "10.5240/7EC7-228A-510A-053E-CBB8-J".
`editEIDR`	Texto	Altamente recomendável Por quê? - Um identificador EIDR (Registro Identificador de Entretenimento) que representa uma edição específica de uma obra cinematográfica ou televisiva. Por exemplo, o filme "Os Caça-Fantasmas", cujo EIDR do título é "10.5240/7EC7-228A-510A-053E-CBB8-J", tem várias edições, como "10.5240/1F2A-E1C5-680A-14C6-E76B-I" e "10.5240/8A35-3BEE-6497-5D12-9E4F-3". A propriedade `titleEIDR` é obrigatória quando "editEIDR" é 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 de ação precisa fornecer o link direto do conteúdo. Se o conteúdo estiver disponível em um canal da LiveTV, essa propriedade será opcional. A entidade `BroadcastService` associada fornece o link direto do canal. Um `Movie` pode estar disponível no VoD e na TV ao vivo. Use uma matriz para especificar diferentes links diretos em várias regiões. Consulte o exemplo Várias regiões e idiomas.
`sameAs`	URL	Altamente recomendável Por quê? Um URL para uma página da Web de referência que pode identificar o filme, por exemplo, a página da Wikipédia do filme. Ele precisa ser diferente da propriedade `url`.
`inLanguage`	Texto	Altamente recomendado: idioma original do filme no formato BCP 47.
`genre`	Texto	Uma lista ordenada de todos os gêneros relevantes. Por exemplo : ["Ação", "Moda", "Meio ambiente", "Futebol"]
`keywords`	Texto	Palavras-chave ou tags usadas para descrever o conteúdo. Também é permitido usar um array 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 recomendável Por quê? - Um `PublicationEvent` é usado para especificar o lançamento original (global ou local) de conteúdo por um editor, como a data de lançamento original de um filme nos cinemas. Além disso, use `FeaturedEvent` para indicar que seu serviço comercializa esse conteúdo como original, em destaque, especial etc. `ExclusiveEvent` especifica que seu serviço tem direitos de distribuição exclusivos e inclui onde e quando. Consulte a seção de exemplos para mais 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 esse evento. Para um `PublicationEvent`, é a região em que o conteúdo foi publicado. Para `FeaturedEvent` e `ExclusiveEvent`, é a região em que o conteúdo é apresentado ou exclusivo. Use códigos ISO 3166 para 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 um `PublicationEvent`, isso indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado pela primeira vez nos cinemas. Para `ExclusiveEvent` e `FeaturedEvent`, isso representa a data de início da exclusividade ou destaque da entidade.
`releasedEvent.endDate`	Date ou DateTime	Recomendado: obrigatório para `ExclusiveEvent`. Isso só se aplica aos tipos `ExclusiveEvent` e `FeaturedEvent`. Para `ExclusiveEvent`, 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 perpetuamente exclusivo ou em destaque, defina `endDate` como 20 anos a partir da data atual.
`releasedEvent.publishedBy`	Organization ou Person	Opcional: a organização ou pessoa que publicou essa entidade.
`description`	Texto	Altamente recomendável Por quê? Uma sinopse do filme. Sinopses de enredo são preferíveis a resumos factuais. Limite de 300 caracteres. Use uma matriz para marcar a descrição em vários idiomas. Consulte o exemplo Várias regiões e idiomas.
`duration`	Duração	A duração do filme no formato ISO 8601. Use o formato "PT00H00M".
`director`	Person	Altamente recomendável Por quê? É quem dirigiu o filme.
`actor`	Person	Altamente recomendável Por quê? São os membros do elenco do filme.
`producer`	Organization ou Person	Altamente recomendável Por quê? Os produtores do filme.
`image`	ImageObject	Obrigatório para o Google TV: 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. Confira o exemplo de Trailer.
`trailer.inLanguage`	Texto	Altamente recomendado: 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	São as regiões onde a mídia é permitida. Se não for especificado, vamos presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
`identifier`	PropertyValue	Altamente recomendável Por quê? - ID externo ou outro ID que identifica claramente esta entidade. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
`review`	Review (em inglês)	Classificações das análises do filme
`review.reviewRating`	Classificação	Obrigatório se uma avaliação for fornecida. É usado para especificar a classificação dada na avaliação.
`contentRating`	Texto ou Classificação	Obrigatório para conteúdo adulto e altamente recomendado para outros casos Por quê? - Classificação geral do conteúdo. Se a classificação do conteúdo for fornecida na forma de uma string de texto, duas variações serão aceitas: A agência de classificação precedida pela classificação com um espaço em branco entre elas. Por exemplo, uma classificação "PG-13" da agência "MPAA" nos EUA precisa ser descrita como "MPAA PG-13". Confira a lista de agências. Um valor "RATING NOT KNOWN" (sem distinção entre maiúsculas e 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 de aviso do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = Diálogo, FV = Violência de fantasia, L = Linguagem, S = Conteúdo sexual, V = Violência.
`popularityScore`	PopularityScoreSpecification	Altamente recomendável Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia reproduzir para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros itens do seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os seus feeds e entre todas as entidades do 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 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 global (TERRA)
`category`	Texto	Obrigatório, se aplicável: preencha essa propriedade se a entidade for uma variante de `Movie`. Defina `category` como qualquer uma das seguintes opções: `Home Release`: uma versão vendida ou alugada para exibição doméstica. `Theatrical Release`: uma versão lançada nos cinemas. `International Release`: uma versão editada para lançamento internacional. `Remastered`: uma versão cujas imagens, som ou ambos foram aprimorados para um padrão mais atualizado. `Unrated`: uma versão que não foi avaliada 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 que o lançamento nos cinemas.
`workExample`	Filme	Especifica as variantes do filme. Inclua essa propriedade na entidade `Movie` principal, não nas entidades `Movie` das versões variantes.
`workExample.@id`	URL	Para variantes de `Movie`, essa propriedade fornece o `@id` da entidade `Movie` de que ela é uma variante.
`workExample.@type`	Texto	Obrigatório: sempre definido como `Movie`. Isso pode ser representado como uma matriz para um `Movie` com várias 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 de 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 exibição doméstica. `Theatrical Release`: uma versão lançada nos cinemas. `International Release`: uma versão editada para lançamento internacional. `Remastered`: uma versão cujas imagens, som ou ambos foram aprimorados para um padrão mais atualizado. `Unrated`: uma versão que não foi avaliada 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 que o lançamento nos cinemas.

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"
}

Páginas relacionadas

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

Propriedades de marcação de conteúdo de filmes Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.