Esta página foi traduzida pela API Cloud Translation.

Ações de assistir propriedades comuns

Esta seção fornece detalhes das propriedades comuns das Ações de exibição.

Propriedades de marcação de ação

Propriedade	Tipo esperado	Descrição
`@type`	Texto	Obrigatório: sempre defina como `WatchAction`.
`target`	EntryPoint	Obrigatório: um objeto de destino que fornece o mapeamento de profundo links para várias plataformas do Google.
`target.@type`	Texto	Obrigatório: sempre defina como `EntryPoint`.
`target.urlTemplate`	URL	Obrigatório: A profundo que leva os usuários ao seu app ou plataforma e inicia a reprodução do conteúdo.
`target.inLanguage`	Texto	Opcional: idioma original da série em BCP 47 .
`target.actionPlatform`	Texto	Obrigatório: as plataformas que são mapeadas para `urlTemplate` As ações de mídia oferecem suporte ao seguinte: `http://schema.org/DesktopWebPlatform`: plataforma de pesquisa em navegadores da Web para computadores. `http://schema.org/MobileWebPlatform`: plataforma de pesquisa ativada navegadores da Web para dispositivos móveis. `http://schema.org/AndroidPlatform`: pesquisa e guia do Play plataformas no app Android. `http://schema.org/AndroidTVPlatform`: Android TV no app Android TV. `http://schema.org/IOSPlatform`: plataforma de pesquisa no iOS app. `http://schema.googleapis.com/GoogleVideoCast`: transmissão e Plataformas domésticas em um dispositivo Chromecast. `http://schema.googleapis.com/GoogleAudioCast`: transmissão e Plataformas domésticas em um dispositivo Chromecast (somente ações de áudio). . Consulte a Plataforma de tipos de serviço para conferir os requisitos.
`target.additionalProperty`	PropertyValue	Obrigatório se aplicável: uma lista de pares de propriedade-valor para representam propriedades adicionais do link direto. Isso pode incluir seguintes: `contentLanguage`: o idioma de transmissão (dub), em BCP 47 formato. Se o conteúdo for dublado em outro idioma, é obrigatória. Use uma matriz para vários códigos de idioma. `subtitleLanguage`: os idiomas das legendas ou legendas, em BCP 47 formato. Use uma matriz para vários códigos de idioma. `cameraAngle`: o ângulo da câmera para o conteúdo. para exemplo, "Nível dos olhos" e "Alta angular". Se o conteúdo estiver disponível diferentes ângulos de câmera, essa propriedade é obrigatória. Use uma matriz para vários ângulos de câmera. `videoFormat`: o formato do arquivo usado para armazenar o conteúdo digital Data do vídeo por exemplo, "SD" para definição padrão e "HD" para alta definição. Os formatos de vídeo válidos incluem SD, HD, 2K, 4K e 8K. Use uma matriz para vários formatos de vídeo. . Consulte a additionalProperty exemplo.
`actionAccessibilityRequirement`	ActionAccessSpecification	Obrigatório: uma ação objeto de especificação de acesso que descreve o requisito de acesso do o conteúdo. Consulte Ação Acessar as Propriedades da Especificação.

Páginas relacionadas à marcação de ação

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

Propriedades de especificação de acesso à ação

Propriedade	Tipo esperado	Descrição
`actionAccessibilityRequirement.@type`	Texto	Obrigatório: sempre defina como `ActionAccessSpecification`.
`actionAccessibilityRequirement.category`	Texto	Obrigatório: um requisito de acesso ao conteúdo. Para mais informações, consulte Tipo de paywall. Se uma entidade representa um grupo de conteúdos, você precisa definir `category` ao requisito de acesso menos restritivo de seu conteúdo. Por exemplo, se um `TVSeries` tiver O conteúdo `TVEpisode` foi definido como `nologinrequired` e alguns definidos como `subscription`, defina esse `TVSeries` para `nologinrequired`.
`actionAccessibilityRequirement.availabilityStarts`	Data	Obrigatório: data após a qual a ação estará disponível, em ISO formato 8601 (incluindo fuso horário). A data pode ser definida no futuro. É obrigatório fornecer a entidade correspondente no feed em pelo menos sete dias antes da data de availabilityStarts. Isso vai melhorar as chances de o conteúdo aparecer nas plataformas do Google a tempo.
`actionAccessibilityRequirement.availabilityEnds`	Data	Obrigatório: data após a qual a ação não estará mais disponível. em ISO formato 8601 (incluindo fuso horário). Precisa ser igual ou maior que 72 horas após o `availabilityStarts`: Se o conteúdo estiver sempre disponível após a publicação, defina esta ser 20 anos a partir da data atual. É obrigatório que as atualizações na data de availabilityEnds sejam feitas no feed pelo menos sete dias antes da data de término de disponibilidade. Isso aumenta as chances de o conteúdo deixar de aparecer no Google. é mostrada na data de availabilityEnds.
`actionAccessibilityRequirement.eligibleRegion`	País, Cidade, Estado, GeoShape Texto	Obrigatório: regiões em que o conteúdo está disponível. Use o string especial `EARTH` se o conteúdo estiver disponível globalmente.
`actionAccessibilityRequirement.ineligibleRegion`	País, Cidade, Estado ou GeoShape	Obrigatório se aplicável: regiões onde o conteúdo é restritas. Não é necessário fornecer essa propriedade se o conteúdo for disponíveis em qualquer lugar em `eligibleRegion`.
`actionAccessibilityRequirement.requiresSubscription`	MediaSubscription	Obrigatório se aplicável: os detalhes do assinatura de que os usuários precisam para acessar o conteúdo. Consulte Propriedades da assinatura de mídia. Forneça essa propriedade se `category` for `subscription` ou `externalSubscription`.
`actionAccessibilityRequirement.expectsAcceptanceOf`	Oferta	Obrigatório se o conteúdo exigir uma compra: os detalhes do oferta associada ao conteúdo. Forneça as informações de preço do seguintes casos: Conteúdo de compra única (`rental` ou `purchase`) Conteúdo baseado em assinatura que requer uma compra adicional de (`subscription` ou `externalsubscription`) . Se o preço for 0,00, remova totalmente o objeto `Offer` e defina `category` do objeto `ActionAccessSpecification` como `free`. Consulte Propriedades da oferta.

Propriedades da assinatura de mídia

Obrigatório se actionAccessibilityRequirement.category for subscription ou externalSubscription.

Propriedade	Tipo esperado	Descrição
`requiresSubscription.@type`	Texto	Obrigatório: sempre defina como `MediaSubscription`
`requiresSubscription.@id`	URL	Obrigatório: o ID exclusivo da assinatura. Se o conteúdo é acessível por meio de diferentes assinaturas, cada uma delas deve ter um ID exclusivo.
`requiresSubscription.name`	Texto	Obrigatório: o nome da assinatura. Observe o seguinte: Se o conteúdo puder ser acessado por meio de assinaturas diferentes, esta precisa ser igual ao nome no seu sistema de autenticação de usuário. Para por exemplo, se um usuário pode acessar o conteúdo com base na assinatura chamado Package 1, mas o sistema de autenticação usa o nome PKG1a, use PKG1. Para provedores de TVE, esse é o nome do autenticador registrado com seu autenticador de TVE. Ela é uma string que identifica exclusivamente nome do serviço com o TVE Authenticator.
`requiresSubscription.sameAs`	URL	A página que descreve a assinatura.
`requiresSubscription.identifier`	Texto	Obrigatório se `category` for `subscription` E `commonTier` é `false` – É uma string exclusiva para essa assinatura que representa o acesso a um grupo de conteúdo no catálogo de mídia. O Google recomenda usar a seguinte sintaxe para o identificador: nome do domínio + dois-pontos (:) + nível de acesso ao conteúdo, exemplos : example.com:basic, example.com:premium, example.com:esportes Essa propriedade será igual à identificador de direitos se você estiver fornecendo uma API de direitos
`requiresSubscription.authenticator`	Organização	Obrigatório se `category` for `externalsubscription`: um contêiner que fornece o detalhes do autenticador do provedor externo.
`requiresSubscription.authenticator.@type`	Texto	Obrigatório se `category` for `externalsubscription` - Sempre definido como `Organization`.
`requiresSubscription.authenticator.name`	Texto	Obrigatório se `category` for `externalsubscription`: o nome da autenticação serviço. Para provedores de TVE, defina como TVE
`requiresSubscription.commonTier`	Booleano	Obrigatório se aplicável: será obrigatório se a categoria estiver definida como assinatura. Leia mais sobre commonTier na comum documentação de requisitos de nível.

Requisitos da API de direitos

Uma API de direitos é obrigatório se actionAccessibilityRequirement.category for subscription ou externalSubscription e sua oferta de assinatura inclui várias pacotes ou níveis ou tem suporte para complementos. Não inclua essa informação se é dividida em níveis e dá acesso a todo o conteúdo do catálogo.

A Empresa A tem uma única oferta de assinatura que oferece aos usuários inscritos acesso a todo o conteúdo disponível: o identificador de direitos / API não é obrigatório
A Empresa B tem uma assinatura básica que fornece acesso a alguns conteúdos e uma assinatura premium que fornece acesso a conteúdo premium: Identificador de direitos / API obrigatório
A Empresa C tem uma assinatura básica que fornece acesso a alguns conteúdos e pacotes que fornecem acesso a conteúdo de terceiros: Identificador de direitos / API obrigatório

Páginas relacionadas a assinaturas de mídia

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

Propriedades da oferta

Propriedade	Tipo esperado	Descrição
`expectsAcceptanceOf.@type`	Texto	Obrigatório: sempre defina como `Offer`.
`expectsAcceptanceOf.price`	Número	Obrigatório: o preço de compra do conteúdo. O preço precisa ser um valor positivo diferente de zero. Para entidades com preço igual a 0,00, especifique a categoria como "sem custo financeiro".
`expectsAcceptanceOf.priceCurrency`	Texto	Obrigatório: a moeda do preço em três letras. ISO 4217.
`expectsAcceptanceOf.seller`	Organização	É a organização que oferece a compra de conteúdo.
`expectsAcceptanceOf.seller.@type`	Texto	Sempre defina como `Organization`.
`expectsAcceptanceOf.seller.name`	Texto	O nome do vendedor.
`expectsAcceptanceOf.seller.sameAs`	Texto	O URL de uma página da Web que identifica o vendedor. por exemplo, os na página inicial do vendedor.

Página relacionada à oferta

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

Identificadores

Os feeds de ação de mídia aceitam vários identificadores que podem ajudar a identificar um entidade de forma inequívoca. Esses identificadores podem ajudar a acelerar de reconciliar o conteúdo do seu feed com o conteúdo do bancos de dados. Embora a maioria desses identificadores possa ser adicionada ao feed usando o método a propriedade identifier em vários tipos de entidades, os EIDRs têm os próprios propriedade representativa. Ambas serão discutidas abaixo.

Propriedades do identificador

Propriedade	Tipo esperado	Descrição
`identifier`	Texto	Altamente recomendado: é um identificador, geralmente externo, que identifica claramente uma determinada entidade. Vários identificadores são permitidos. Essa propriedade está disponível em todos os tipos de entidade "Ação de assistir". A tabela abaixo lista os identificadores e subpropriedades aceitos da propriedade `identifier`. Confira o exemplo de identificador/EIDR (em inglês) na seção de exemplos de feed do Ações de exibição.

Propriedade	Tipo esperado	Descrição
`@type`	Texto	Obrigatório: sempre defina como `PropertyValue`.
`propertyID`	Texto	Obrigatório - Oferecemos suporte aos seguintes tipos de ID: `TMS_ROOT_ID`: o ID raiz da Gracenote (TMS) (por exemplo, 15829). do Google. Isso não se aplica às organizações e Entidades BroadcastService em que apenas TMS_ID precisa ser usado. `TMS_ID`: o ID da variante da Gracenote (TMS) (por exemplo, MV000398520000). `WIKIDATA_ID`: o ID do WikiData (por exemplo, Q134773). `IMDB_ID`: o ID do IMDB (por exemplo, tt0109830). `OPTA_ID`: o ID da OPTA Sports. `STATS_ID`: o ID de execução STATS. `VIP_TIMES_ID`: ID do VIPTimes (Nihon Tarento Meikan) do Japão para talentos japoneses. `DMA_ID`: o código de área de marketing designado dos EUA, usado em GeoShapes. `_PARTNER_ID_`: essa propriedade precisa conter a string. "_PARTNER_ID_", o valor precisa ser um ID exclusivo usado por uma o provedor de serviços, interna ou externamente, para identificar a entidade (por exemplo, 12345 ou a5c604e2-e9e5-4ff3-b728-245799dc37f1).
`value`	Texto	Obrigatório: o valor do sistema de IDs especificado.

Propriedades EIDR

EIDR (abreviação de "Entertainment Identifier Registry" em inglês) é um sistema identificador globalmente exclusivo para uma ampla gama de conteúdos de mídia, incluindo filmes e programas de televisão. O sistema de identificação resolve um identificador para um registro de metadados associado a títulos de alto nível, edições e muito mais. A tabela a seguir lista as propriedades associadas ao EIDR e o uso delas.

Propriedade	Tipo esperado	Descrição
`titleEIDR`	Texto	Altamente recomendado: um identificador do Registro Identificador de Entretenimento (EIDR, na sigla em inglês) representa, no nível mais geral/abstrato, uma obra de filme ou televisão. Essa propriedade está disponível nas páginas de especificação das entidades TVSeries, TVSeason, TVEpisode e Movie. Por exemplo, o titleEIDR do filme conhecido como "Ghostbusters" é "10.5240/7EC7-228A-510A-053E-CBB8-J". Consulte o exemplo de identificador/EIDR na seção de exemplos de feed das Ações de exibição.
`editEIDR`	Texto	Altamente recomendado: um identificador do Registro Identificador de Entretenimento (EIDR, na sigla em inglês) representa uma edição/edição específica de um filme ou uma obra de televisão. Essa propriedade está disponível nas páginas de especificação de entidades TVEpisode e Movie. Por exemplo, o filme conhecido como "Ghostbusters" 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 `editEIDR` é fornecido. Consulte Exemplo de identificador/EIDR na seção de exemplos de feed das Ações de exibição.

Agências de classificação de conteúdo

Use os valores desta tabela para BroadcastService.contentRating, Movie.contentRating e TVSeries.contentRating. A agência de classificação precisa incluir o valor da classificação no início. Exemplos:

Um filme classificado como "R" nos EUA, o valor Movie.contentRating precisa ser "MPAA R".
Uma série de TV classificada como "TV-MA" nos EUA, o valor de TVSeries.contentRating deve ser "TVPG TV-MA".

País	Agência de classificação de TV	Agência de classificação de filmes
Albânia (AL)	Indisponível	Indisponível
Angola (AO)	Indisponível	CCE
Antígua e Barbuda (AG)	Indisponível	MPAA
Argentina (AR)	INCAA	INCAA
Armênia (AM)	Indisponível	MKRF/RUSSIA
Aruba (AW)	Indisponível	Indisponível
Austrália (AU)	ACB TV	Filmes da ACB
Áustria (AT)	FSK	FSK
Azerbaijão (AZ)	Indisponível	MKRF/RUSSIA
Barein (BH)	Indisponível	MPAA
Belarus (BY)	Indisponível	MKRF/RUSSIA
Bélgica (BE)	Indisponível	MPAA
Belize (BZ)	Indisponível	Indisponível
Benin (BJ)	Indisponível	CNC
Bolívia (BO)	Indisponível	MPAA
Bósnia e Herzegovina (BA)	Indisponível	MPAA
Botsuana (BW)	Indisponível	MPAA
Brasil (BR)	CLASSIFICAR	CLASSIFICAR
Burkina Fasso (BF)	Indisponível	CNC
Camboja (KH)	Indisponível	Indisponível
Canadá (CA)	CA_TV	CHVRS
Cabo Verde (CV)	Indisponível	CCE
Chile (CL)	Indisponível	MPAA
Colômbia (CO)	Indisponível	MPAA
Costa Rica (CR)	Indisponível	MPAA
Croácia (HR)	Indisponível	Indisponível
Chipre (CY)	Indisponível	GRFILM
República Tcheca (CZ)	Indisponível	CZFILM
Dinamarca (DK)	Indisponível	MCCYP
Equador (CE)	Indisponível	MPAA
Egito (EG)	Indisponível	MPAA
El Salvador (SV)	Indisponível	MPAA
Estônia (EE)	Indisponível	EEFILM
Fijiano (FJ)	Indisponível	Indisponível
Finlândia (FI)	Indisponível	MEKU (em coreano e inglês)
França (FR)	CSA	CSA
Gabão (GA)	Indisponível	CNC
Alemanha (DE)	FSK	FSK
Grécia (GR)	ESR	GRFILM
Guatemala (GT)	Indisponível	MPAA
Haiti (HT)	Indisponível	Indisponível
Honduras (HN)	Indisponível	MPAA
Hong Kong (HK)	CA	FCO
Hungria (HU)	Indisponível	MPAA
Islândia (IS)	Indisponível	KIJKWIJZER
Índia (IN)	CBFC	CBFC
Indonésia (ID)	KPI	LSF
Irlanda (IE)	Indisponível	IFCO
Itália (IT)	AGCOM	AGCOM
Costa do Marfim (CI)	Indisponível	CNC
Jamaica (JM)	Indisponível	MPAA
Japão (JP)	NA	EIRIN
Jordânia (JO)	Indisponível	MPAA
Cazaquistão (KZ)	Indisponível	MRKF
Coreia do Sul (KR)	KMRB	KMRB
Kuwait (KW)	Indisponível	MPAA
Quirguistão (KG)	Indisponível	MKRF/RUSSIA
Laos (LA)	Indisponível	Indisponível
Letônia (LV)	Indisponível	NKCLV
Líbano (LB)	Indisponível	MPAA
Lituânia (LT)	Indisponível	Indisponível
Luxemburgo (LU)	Indisponível	KIJKWIJZER
Macedônia (MK)	Indisponível	MPAA
Malásia (MY)	Indisponível	FCBM
Mali (ML)	Indisponível	CNC
Malta (MT)	Indisponível	MCCAA
Maurício (MU)	Indisponível	BBFC (link em inglês)
México (MX)	RTC	RTC
Moldávia (MD)	Indisponível	Indisponível
Namíbia (NA)	Indisponível	Indisponível
Nepal (NP)	Indisponível	MPAA
Países Baixos (NL)	KIJKWIJZER	KIJKWIJZER
Nova Zelândia (NZ)	BSA	OFLC
Nicarágua (NI)	Indisponível	MPAA
Níger (NE)	Indisponível	CNC
Noruega (NO)	Indisponível	MEDIETILSYNET
Omã (OM)	Indisponível	MPAA
Panamá (PA)	Indisponível	MPAA
Papua Nova Guiné (PG)	Indisponível	MPAA
Paraguai (PY)	Indisponível	MPAA
Peru (PE)	Indisponível	MPAA
Filipinas (PH)	MTRCB	MTRCB
Polônia (PL)	Indisponível	MPAA
Portugal (PT)	Indisponível	CCE
Catar (QA)	Indisponível	MPAA
Rússia (RU)	MKRF/RUSSIA	MKRF/RUSSIA
Ruanda (RW)	Indisponível	CNC
Arábia Saudita (SA)	Indisponível	MPAA
Senegal (SN)	Indisponível	MPAA
Singapura (SG)	Indisponível	MDA
Eslováquia (SK)	Indisponível	MPAA
Eslovênia (SI)	Indisponível	MPAA
África do Sul (ZA)	FPB	FPB
Espanha (ES)	SETSI	ICAA
Sri Lanka (LK)	Indisponível	Indisponível
Suécia (SE)	Indisponível	SMSA
Suíça (CH)	FSK	FSK
Taiwan (TW)	Indisponível	MOCTW
Tajiquistão (TJ)	Indisponível	MKRF/RUSSIA
Tanzânia (TZ)	Indisponível	MPAA
Tailândia (TH)	Indisponível	BFVC
Togo (TG)	Indisponível	CNC
Trinidad e Tobago (TT)	Indisponível	Indisponível
Turquia (TR)	RTÜK	ECBMCT
Turcomenistão (TM)	Indisponível	MKRF/RUSSIA
Uganda (UG)	Indisponível	MPAA
Ucrânia (UA)	Indisponível	Indisponível
Emirados Árabes Unidos (AE)	Indisponível	MPAA
Reino Unido (GB)	BBFC (link em inglês)	BBFC (link em inglês)
Estados Unidos (EUA)	TV_PG	MPAA
Uruguai (UY)	Indisponível	MPAA
Uzbequistão (UZ)	Indisponível	MKRF/RUSSIA
Venezuela (VE)	Indisponível	RESORTEVIOLENCIA
Vietnã (VN)	Indisponível	MCST
Zâmbia (ZM)	Indisponível	MPAA
Zimbábue (ZW)	Indisponível	MPAA

Propriedades de GeoShape

Um objeto GeoShape contém um dos seguintes tipos de dados:

Uma lista de códigos postais (por exemplo, EUA, Canadá ou outros CEPs)
Uma lista de áreas de classificação progressiva do Canadá
ID da Área designada do mercado (DMA): é um identificador de uma região dos Estados Unidos onde as pessoas recebem os mesmos canais e programas de televisão.

Propriedade	Tipo esperado	Descrição
`@id`	URL	Obrigatório: o identificador da região geográfica no formato de URI.
`@type`	Texto	Obrigatório: sempre defina como `GeoShape`.
`addressCountry`	Texto	Obrigatório: a letra de duas letras ISO Código do país 3166-1 alfa-2
`postalCode`	Texto	Opcional: lista de um ou mais códigos postais e/ou códigos FSA (área de classificação direta).
`identifier`	PropertyValue	Opcional: A O ID da Área designada do mercado (DMA), que é uma identificador de uma região nos Estados Unidos onde as pessoas recebem o os mesmos canais de televisão e programas.
`identifier.@type`	Texto	Obrigatório: sempre defina como `PropertyValue`.
`identifier.propertyID`	Texto	Obrigatório: sempre defina como `DMA_ID`.
`identifier.value`	Texto	Obrigatório: o código de DMA da região.

Exemplo de objeto GeoShape que contém uma lista de CEPs:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

Exemplo de objeto GeoShape que contém uma combinação de FSA (área de classificação direta) e códigos postais:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

Exemplo de objeto GeoShape que contém um ID de DMA:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}