Esta página foi traduzida pela API Cloud Translation.

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 definido como `["http://schema.org", {"@language": "xx"}]` Onde"xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o próprio @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
`@type`	Texto	Obrigatório: defina sempre 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 seu catálogo Estático; o ID deve ser estável e não deve mudar com o tempo (mesmo se a propriedade do URL do programa mudar). Ele será tratado como uma string opaca e não precisa ser um link funcional. na forma de um Identificador de Recursos unificados (URI) O domínio usado para o valor @id deve pertencer à sua organização. Como o `url` de uma entidade atende a todos os requisitos como um 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, usado pelo Google para fazer a correspondência entre o conteúdo no seu feed e o banco de dados do Google. `url` precisa atender aos seguintes requisitos: `url` precisa ser globalmente exclusivo `url` precisa conter um URL canônico que o Google possa rastrear. 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 em 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 (Entretenimento Identifier Registry), representando no nível mais geral/abstrato, uma obra de filme ou televisão. Por exemplo, o título EIDR para o filme conhecido como "Os Caça-Fantasmas" é "10.5240/7EC7-228A-510A-053E-CBB8-J".
`editEIDR`	Texto	Altamente recomendado Por quê? - Um identificador EIDR (Entretenimento Identifier Registry), representando uma edição / edição específica para uma obra de filme ou televisão. Por exemplo, o filme conhecido como "Os Caça-Fantasmas", cujo título EIDR é "10.5240/7EC7-228A-510A-053E-CBB8-J", tem várias edições, por exemplo, "10.5240/1F2A-E1C5-680A-14C6-E76B-404-44". A propriedade `titleEIDR` é obrigatória quando o EIDR de 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 no Video on Demand (VoD), essa propriedade será obrigatória. O objeto de marcação Ação precisa fornecer o link direto do conteúdo. Se o conteúdo estiver disponível em um canal LiveTV, esta propriedade é 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 links diretos diferentes em várias regiões. Veja o exemplo em Várias regiões e idiomas.
`sameAs`	URL	Altamente recomendado 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	Idioma original do filme no formato BCP 47.
`genre`	Texto	Uma lista ordenada de todos os gêneros relevantes. Por exemplo : ["Action", "Fashion", "Environment", "Football"]
`keywords`	Texto	Palavras-chave ou tags usadas para descrever esse conteúdo. Uma matriz de palavras-chave também é permitida. Por exemplo, ["recurso, biografia"] 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) de conteúdo por um editor, como a data de lançamento cinematográfico original 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 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 este evento. Para `PublicationEvent`, essa é a região em que o conteúdo foi publicado. Para `FeaturedEvent` e `ExclusiveEvent`, essa é a região em que o conteúdo é destacado ou exclusivo. Use códigos ISO 3166 para países. Para indicar em qualquer lugar 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 desta entidade, como a data em que um filme foi lançado nos cinemas pela primeira vez. Para `ExclusiveEvent` e `FeaturedEvent`, representa a data de início de quando a entidade é exclusiva ou está em destaque.
`releasedEvent.endDate`	Date ou DateTime	Recomendado - Obrigatório para `ExclusiveEvent` - Aplicável apenas aos tipos `ExclusiveEvent` e `FeaturedEvent`. Para `ExclusiveEvent`, representa a data em que os direitos do conteúdo expiram. Para `FeaturedEvent`, representa a última data em que o provedor apresenta a entidade. Se o conteúdo for perpétuamente exclusivo ou em destaque, defina `endDate` como 20 anos a partir da data atual.
`releasedEvent.publishedBy`	Organization ou Person	Opcional: é a organização ou a pessoa que publicou a entidade.
`description`	Texto	Altamente recomendado Por quê? Uma sinopse do filme. Sinopses do enredo são preferenciais aos resumos factuais. Limite de 300 caracteres. Use uma matriz para marcar a descrição em vários idiomas. Veja o exemplo em Várias regiões e idiomas.
`duration`	Duração	É o ambiente 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ê? São os membros do elenco do filme.
`producer`	Organization ou Person	Altamente recomendado 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. Veja o exemplo do trailer.
`trailer.inLanguage`	Texto	O idioma do trailer no formato BCP 47.
`trailer.url`	URL	O URL de um trailer hospedado publicamente e enviado por seus 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. Ele é usado para especificar a classificação dada na avaliação.
`contentRating`	Texto ou Classificação	Obrigatório para conteúdo adulto. Recomendável em 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, serão aceitas duas variações: A agência de classificação precedeu a avaliação com um espaço em branco entre eles. Por exemplo, uma classificação "PG-13" da agência "MPAA" nos EUA deve ser descrita como "MPAA PG-13". Veja a lista de agências. Um valor de "RATING NOT KNOWN" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do filme.
`contentRating.author`	Texto ou 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 de fantasia , L = idioma, S = conteúdo sexual, V = violência.
`popularityScore`	Pontuação de popularidade	Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros sinais, para determinar qual mídia deve 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 entre os feeds, entre todas as entidades do seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
`popularityScore.@type`	Texto	Sempre definido 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 mais popularidade.
`popularityScore.eligibleRegion`	País	Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for globalmente aplicável, defina como `EARTH`. Por padrão, essa propriedade é definida como `EARTH`. `Note:` A popularidade específica por localidade tem precedência sobre a popularidade global (EARTH)
`category`	Texto	Obrigatório se aplicável: preencha esta 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 residencial. `Theatrical Release`: uma versão lançada nos cinemas. `International Release`: uma versão editada para lançamento internacional. `Remastered`: uma versão com imagens, sons ou ambos aprimorados para um padrão mais atualizado. `Unrated`: uma versão que não foi analisada 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 a versão cinematográfica.
`workExample`	Filme	Especifica as variantes do filme. Inclua essa propriedade na entidade principal `Movie`, não nas entidades `Movie` das versões variantes.
`workExample.@id`	URL	Para variantes `Movie`, essa propriedade fornece o `@id` da entidade `Movie` de que essa é uma variante.
`workExample.@type`	Texto	Obrigatório: defina sempre 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 de filme de uma versão específica. Defina a categoria para uma das seguintes opções: `Home Release`: uma versão vendida ou alugada para visualização residencial. `Theatrical Release`: uma versão lançada nos cinemas. `International Release`: uma versão editada para lançamento internacional. `Remastered`: uma versão com imagens, sons ou ambos aprimorados para um padrão mais atualizado. `Unrated`: uma versão que não foi analisada 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 a versão cinematográfica.

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 estendida

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 páginas a seguir para ver os tópicos relacionados a essas propriedades: