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 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	Recomendado – Obrigató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. Use uma matriz para marcar a descrição em vários idiomas. Veja o exemplo Várias regiões e idiomas.
`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"
}

Páginas relacionadas

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