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"}]` 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 `Movie` para filmes.
`@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. Para o link direto da reprodução, consulte a propriedade `urlTemplate` do objeto alvo.
`name`	Texto	Obrigatório: o nome do filme. Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo de 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 (registro de identificador de entretenimento) que represente, no nível mais geral/abstrato, uma obra de cinema ou televisão. Por exemplo, o titleEIDR do filme "Ghostbusters" é "10.5240/7EC7-228A-510A-053E-CBB8-J".
`editEIDR`	Texto	Altamente recomendado Por quê? - Um identificador EIDR (Registro de Identificador de Entretenimento) que representa uma edição específica de um filme ou programa de TV. Por exemplo, o filme "Ghostbusters", cujo titleEIDR é "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 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 de TV ao vivo, essa propriedade será opcional. A entidade `BroadcastService` associada vai fornecer 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 de várias regiões e idiomas.
`sameAs`	URL	Altamente recomendado Por quê? Um URL de uma página da Web de referência que possa 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 : ["Ação", "Moda", "Meio ambiente", "Futebol"]
`keywords`	Texto	Palavras-chave ou tags usadas para descrever esse conteúdo. Uma matriz de palavras-chave também é permitida. 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) de conteúdo por um editor, como a data de lançamento original nos cinemas 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 exemplos para conferir detalhes e exemplos.
`releasedEvent.@type`	Texto	Obrigatório: 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. No caso de `PublicationEvent`, é a região em que o conteúdo foi publicado. No caso de `FeaturedEvent` e `ExclusiveEvent`, é a região em que o conteúdo é destaque 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 denota a data de lançamento inicial dessa entidade, como a data em que um filme foi lançado nos cinemas. Para `ExclusiveEvent` e `FeaturedEvent`, isso representa a data de início em que a entidade é exclusiva ou 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 de expiração dos direitos do conteúdo. Para `FeaturedEvent`, representa a última data em que o provedor apresenta a entidade. Se o conteúdo for sempre exclusivo ou em destaque, defina o `endDate` como 20 anos a partir da data atual.
`releasedEvent.publishedBy`	Organization ou Person	Opcional: a organização ou pessoa que publicou a entidade.
`description`	Texto	Altamente recomendado Por quê? Uma sinopse do filme. As sinopses da trama são preferidas aos resumos factuais. Limite de 300 caracteres. Use uma matriz para marcar a descrição em vários idiomas. Consulte o exemplo de várias regiões e idiomas.
`duration`	Duração	Duraçã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`	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. Confira o exemplo de trailer.
`trailer.inLanguage`	Texto	O idioma do trailer no formato BCP 47.
`trailer.url`	URL	Um URL de um trailer hospedado publicamente e enviado por 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, será considerado que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
`identifier`	PropertyValue	Altamente recomendado 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)	Confira as classificações do filme
`review.reviewRating`	Classificação	Obrigatório se a revisão for fornecida. É usado para especificar a nota dada na avaliação.
`contentRating`	Texto ou Classificação	Obrigatório para conteúdo adulto, altamente recomendado para outros tipos de conteúdo 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 foi adicionada à classificação com um espaço em branco no meio. Por exemplo, uma classificação "PG-13" da agência "MPAA" nos EUA precisa ser descrita como "MPAA PG-13". Consulte a lista de agências. Um valor de "RATING NOT KNOWN" (maiúsculas e minúsculas não são diferenciadas) 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 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)
`category`	Texto	Obrigatório se aplicável: preencha essa propriedade se a entidade for uma variante `Movie`. Defina `category` como um dos seguintes: `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, o som ou ambos são aprimorados para um padrão mais atualizado. `Unrated`: uma versão que não foi exibida pela MPAA ou por uma agência semelhante. `Director Cut`: uma versão que representa a edição aprovada pelo diretor. `Extended Cut`: uma versão mais longa do que a versão para 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 de `Movie`, essa propriedade fornece o `@id` da entidade `Movie` da qual essa variante é 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 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, o som ou ambos são aprimorados para um padrão mais atualizado. `Unrated`: uma versão que não foi exibida pela MPAA ou por uma agência semelhante. `Director Cut`: uma versão que representa a edição aprovada pelo diretor. `Extended Cut`: uma versão mais longa do que a versão para 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"
}

Páginas relacionadas

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