Esta seção fornece os detalhes das propriedades comuns das Ações de assistir.
Propriedades de marcação de ação
Propriedade | Tipo esperado | Descrição |
---|---|---|
@type |
Texto | Obrigatório: sempre definido como WatchAction . |
target |
Ponto de entrada | Obrigatório: um objeto de destino que fornece o mapeamento de links diretos para várias plataformas do Google. |
target.@type |
Texto | Obrigatório: sempre definido como EntryPoint . |
target.urlTemplate |
URL | Obrigatório: é um link direto que direciona os usuários ao app ou plataforma e inicia a reprodução do conteúdo. |
target.inLanguage |
Texto | Opcional: idioma original da série no formato 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:
|
target.additionalProperty |
PropertyValue | Obrigatório, se aplicável: uma lista de pares de chave-valor para representar propriedades adicionais do link direto. Isso pode incluir
o seguinte:
|
actionAccessibilityRequirement |
ActionAccessSpecification (em inglês) | Obrigatório: um objeto de especificação de acesso de ação que descreve o requisito de acesso do conteúdo. Consulte Propriedades da especificação de acesso de ações. |
Páginas relacionadas à marcação de ação
Consulte as seguintes páginas para os tópicos relacionados a essas propriedades:
- Visão geral da marcação de ação
- Identificar os links diretos específicos da plataforma para seu conteúdo
Propriedades da especificação de acesso de ação
Propriedade | Tipo esperado | Descrição |
---|---|---|
actionAccessibilityRequirement.@type |
Texto | Obrigatório: sempre definido como ActionAccessSpecification . |
actionAccessibilityRequirement.category |
Texto | Obrigatório: é um requisito de acesso para o conteúdo. Para mais informações, consulte Tipo de paywall. Caso uma entidade represente um grupo de conteúdo, será necessário definir
|
actionAccessibilityRequirement.availabilityStarts |
Date | Obrigatório: data depois em que a ação estará disponível, no formato ISO 8601 (incluindo fuso horário).
É necessário que a entidade correspondente seja fornecida no feed pelo menos sete dias antes da data de "startStarts" Isso aumenta as chances de o conteúdo aparecer nas plataformas do Google a tempo. |
actionAccessibilityRequirement.availabilityEnds |
Date | Obrigatório: data depois da qual a ação não estará mais disponível, no formato ISO 8601 (incluindo fuso horário).
É necessário que as atualizações na dataavailabilityEnds sejam feitas no feed pelo menos sete dias antes da data disponibilidade. Isso aumenta as chances de o conteúdo parar de aparecer nas plataformas do Google na data disponibilidade. |
actionAccessibilityRequirement.eligibleRegion |
País, Cidade, Estado, GeoShape ou Texto | Obrigatório: regiões em que o conteúdo está disponível. Use a
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 em que o conteúdo é restrito. Não é necessário fornecer essa propriedade se o conteúdo estiver
disponível em qualquer lugar no eligibleRegion . |
actionAccessibilityRequirement.requiresSubscription |
Assinatura de mídia | Obrigatório, se aplicável: são os detalhes da assinatura que os usuários precisam para acessar o conteúdo. Consulte Propriedades da assinatura de mídia.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Oferta | Obrigatório se o conteúdo exigir uma compra: os detalhes da
oferta associada ao conteúdo. Forneça as informações de preço para os
seguintes casos:
Offer e defina category do objeto ActionAccessSpecification como free . Consulte Propriedades da oferta.
|
Propriedades de assinatura de mídia
Obrigatório se actionAccessibilityRequirement.category
for subscription
ou externalSubscription
.
Propriedade | Tipo esperado | Descrição |
---|---|---|
requiresSubscription.@type |
Texto | Obrigatório: sempre definido como MediaSubscription |
requiresSubscription.@id |
URL | Obrigatório: é o ID exclusivo da assinatura. Se o conteúdo puder ser acessado por meio de assinaturas diferentes, cada uma precisará ter um ID exclusivo. |
requiresSubscription.name |
Texto | Obrigatório: o nome da assinatura. Observe o seguinte:
|
requiresSubscription.sameAs |
URL | A página que descreve a assinatura. |
requiresSubscription.identifier |
Texto | Obrigatório se category for subscription E commonTier for false
:
uma string única dessa assinatura que representa o acesso a um grupo de conteúdo no seu catálogo de mídia.
|
requiresSubscription.authenticator |
Organização | Obrigatório se category for
externalsubscription : um contêiner que fornece os
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 do serviço de autenticação. Para provedores TVE, defina como TVE |
requiresSubscription.commonTier |
Booleano | Obrigatório, se aplicável: obrigatório se a categoria estiver definida como assinatura. Saiba mais sobre CommonTier na documentação de requisitos de nível comum. |
Requisitos da API de direitos
Uma API de direito será
necessária se actionAccessibilityRequirement.category
for subscription
ou
externalSubscription
e sua oferta de assinatura incluir vários
pacotes ou níveis ou se for compatível com complementos. Não inclua isso se a
assinatura tiver um nível e conceder acesso a todo o conteúdo do seu catálogo.
- A empresa A tem uma única oferta de assinatura que fornece 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 oferece acesso a conteúdo premium: o identificador de direito / API é obrigatório
- A empresa C tem uma assinatura de base que fornece acesso a alguns conteúdos e adiciona pacotes que fornecem acesso a conteúdo de terceiros: Identificador de direito / API é obrigatório
Páginas relacionadas à assinatura de mídia
Consulte as seguintes páginas para os tópicos relacionados a essas propriedades:
Propriedades da oferta
Propriedade | Tipo esperado | Descrição |
---|---|---|
expectsAcceptanceOf.@type |
Texto | Obrigatório: sempre definido 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 de 0,00, especifique a categoria como "free". |
expectsAcceptanceOf.priceCurrency |
Texto | Obrigatório: moeda do preço no formato ISO 4217 de três letras. |
expectsAcceptanceOf.seller |
Organização | É a organização que oferece a compra de conteúdo. |
expectsAcceptanceOf.seller.@type |
Texto | Sempre definir 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, a página inicial dele. |
Página relacionada à oferta
Consulte as seguintes páginas para os tópicos relacionados a essas propriedades:
Identificadores
Os feeds de Ações de mídia aceitam vários identificadores que podem ajudar a identificar uma
entidade de maneira ambígua. Esses identificadores podem ajudar a acelerar o processo de reconciliação do conteúdo do feed com o conteúdo dos bancos de dados do Google. Embora a maioria desses identificadores possa ser adicionada ao feed usando a propriedade
identifier
em vários tipos de entidades, os EIDRs têm propriedades próprias
de representação. Ambos são discutidos abaixo.
Propriedades do identificador
Propriedade | Tipo esperado | Descrição |
---|---|---|
identifier |
Texto | Altamente recomendado: um identificador, geralmente um externo, que identifica claramente uma determinada entidade. Vários identificadores são permitidos. Essa propriedade está disponível em todos os tipos de entidade de ação de assistir. A tabela abaixo lista os identificadores aceitos e as subpropriedades da propriedade identifier . Consulte o exemplo de identificador/EIDR na seção "Exemplos de feeds de ações de exibição". |
Propriedade | Tipo esperado | Descrição |
---|---|---|
@type |
Texto | Obrigatório: sempre definido como PropertyValue . |
propertyID |
Texto | Obrigatório: aceitamos os seguintes tipos de IDs:
|
value |
Texto | Obrigatório: valor do sistema de ID especificado. |
Propriedades EIDR
O EIDR (abreviação de The Entertainment Identifier Registry) é um sistema de identificação global exclusivo para uma ampla variedade de conteúdo 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 edições, títulos de nível superior e muito mais. A tabela a seguir lista as propriedades associadas a EIDR e o uso delas.
Propriedade | Tipo esperado | Descrição |
---|---|---|
titleEIDR |
Texto | Altamente recomendado: um identificador de entretenimento identificador (EIDR, na sigla em inglês) representa, no nível mais geral/abstrata, uma obra cinematográfica ou de televisão. Essa propriedade está disponível nas páginas de especificação de entidade TVSeries, TVSeason, TVEpisódio e Filme. Por exemplo, o título EIDR para a cinematografia conhecida como "Caçadores de fantasmas" é "10.5240/7EC7-228A-510A-053E-CBB8-J". Veja o exemplo do identificador /Exemplo de ação no exemplo do feed. |
editEIDR |
Texto | Altamente recomendado: um identificador de entretenimento (identificador de entretenimento) EIDR representa uma edição/edição específica para uma obra cinematográfica ou de televisão. Esta propriedade está disponível nas páginas de especificação de entidade TVEpisódio e Filme. Por exemplo, a imagem de movimento conhecida como "Caçadores de fantasmas" com o título "10.5240/7EC7-228A-510A-053E-CBB8-2 -65-55-5-5-1-5- - ". |
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 ser adicionada antes do valor da nota. Exemplos:
- Um filme classificado como "R" nos EUA precisa ter o valor
Movie.contentRating
"MPAA R". - Uma série de TV com classificação "TV-MA" nos EUA deve ter um valor
TVSeries.contentRating
de "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 (link em japonês) |
Argentina (AR) | INCAA | INCAA |
Armênia (AM) | Indisponível | MKRF/RÚSSIA |
Aruba (AW) | Indisponível | Indisponível |
Austrália (AU) | TV ACB | Filmes da ACB |
Áustria (AT) | FSK (em inglês) | FSK (em inglês) |
Azerbaijão (AZ) | Indisponível | MKRF/RÚSSIA |
Barein (BH) | Indisponível | MPAA (link em japonês) |
Bielorrússia (BY) | Indisponível | MKRF/RÚSSIA |
Bélgica (BE) | Indisponível | MPAA (link em japonês) |
Belize (BZ) | Indisponível | Indisponível |
Benin (BJ) | Indisponível | CNC |
Bolívia (BO) | Indisponível | MPAA (link em japonês) |
Bósnia e Herzegovina (BA) | Indisponível | MPAA (link em japonês) |
Botsuana (BW) | Indisponível | MPAA (link em japonês) |
Brasil (BR) | CLASSIFICAÇÃO | CLASSIFICAÇÃO |
Burquina Fasso (BF) | Indisponível | CNC |
Camboja (KH) | Indisponível | Indisponível |
Canadá (CA) | CA_TV (link em inglês) | CHVRS (link em inglês) |
Cabo Verde (CV) | Indisponível | CCE |
Chile (CL) | Indisponível | MPAA (link em japonês) |
Colômbia (CO) | Indisponível | MPAA (link em japonês) |
Costa Rica (CR) | Indisponível | MPAA (link em japonês) |
Croácia (HR) | Indisponível | Indisponível |
Chipre (CY) | Indisponível | GRFILM |
República Tcheca (CZ) | Indisponível | CZFILM |
Dinamarca (DK) | Indisponível | MCCYP (link em inglês) |
Equador (CE) | Indisponível | MPAA (link em japonês) |
Egito (EG) | Indisponível | MPAA (link em japonês) |
El Salvador (SV) | Indisponível | MPAA (link em japonês) |
Estônia (EE) | Indisponível | EEFILM |
Fiji (FJ) | Indisponível | Indisponível |
Finlândia (FI) | Indisponível | MEKU (link em alemão) |
França (FR) | CSA (em inglês) | CSA (em inglês) |
Gabão (GA) | Indisponível | CNC |
Alemanha (Alemanha) | FSK (em inglês) | FSK (em inglês) |
Grécia (GR) | ESR | GRFILM |
Guatemala (GT) | Indisponível | MPAA (link em japonês) |
Haiti (HT) | Indisponível | Indisponível |
Honduras (HN) | Indisponível | MPAA (link em japonês) |
Hong Kong (HK) | Canadá | Alimentos, bebidas e restaurantes |
Hungria (HU) | Indisponível | MPAA (link em japonês) |
Islândia (IS) | Indisponível | KIJKWIJZER (link em japonês) |
Índia (IN) | CBFC (em inglês) | CBFC (em inglês) |
Indonésia (ID) | KPI | LSF (link em alemão) |
Irlanda (IE) | Indisponível | IFCO (link em sueco) |
Itália (IT) | VEJA | VEJA |
Costa do Marfim (CI) | Indisponível | CNC |
Jamaica (JM) | Indisponível | MPAA (link em japonês) |
Japão (JP) | Não relevante | EIRIN |
Jordânia (JO) | Indisponível | MPAA (link em japonês) |
Cazaquistão (KZ) | Indisponível | RMKF |
Coreia (Coreia) | KMRB (link em alemão) | KMRB (link em alemão) |
Kuwait (KW) | Indisponível | MPAA (link em japonês) |
Quirguistão (KG) | Indisponível | MKRF/RÚSSIA |
Laos (LA) | Indisponível | Indisponível |
Letônia (LV) | Indisponível | KKCLV (link em holandês) |
Líbano (LB) | Indisponível | MPAA (link em japonês) |
Lituânia (LT) | Indisponível | Indisponível |
Luxemburgo (LU) | Indisponível | KIJKWIJZER (link em japonês) |
Macedônia (MK) | Indisponível | MPAA (link em japonês) |
Malásia (MY) | Indisponível | FCBM (link em alemão) |
Mali (ML) | Indisponível | CNC |
Malta (MT) | Indisponível | MCCAA (link em japonês) |
Maurício (MU) | Indisponível | BBFC (link em inglês) |
México (MX) | RTC (em inglês) | RTC (em inglês) |
Moldávia (MD) | Indisponível | Indisponível |
Namíbia (NA) | Indisponível | Indisponível |
Nepal (NP) | Indisponível | MPAA (link em japonês) |
Países Baixos (NL) | KIJKWIJZER (link em japonês) | KIJKWIJZER (link em japonês) |
Nova Zelândia (NZ) | BSA | OFLC |
Nicarágua (NI) | Indisponível | MPAA (link em japonês) |
Níger (NE) | Indisponível | CNC |
Noruega (NO) | Indisponível | MEDIETILSSINET |
Omã (OM) | Indisponível | MPAA (link em japonês) |
Panamá (PA) | Indisponível | MPAA (link em japonês) |
Papua-Nova Guiné (PG) | Indisponível | MPAA (link em japonês) |
Paraguai (PY) | Indisponível | MPAA (link em japonês) |
Peru (PE) | Indisponível | MPAA (link em japonês) |
Filipinas (PH) | MTRCB (link em alemão) | MTRCB (link em alemão) |
Polônia (PL) | Indisponível | MPAA (link em japonês) |
Portugal (Portugal) | Indisponível | CCE |
Catar (QA) | Indisponível | MPAA (link em japonês) |
Rússia (RU) | MKRF/RÚSSIA | MKRF/RÚSSIA |
Ruanda (RW) | Indisponível | CNC |
Arábia Saudita (SA) | Indisponível | MPAA (link em japonês) |
Senegal (SN) | Indisponível | MPAA (link em japonês) |
Singapura (Singapura) | Indisponível | MDA |
Eslováquia (SK) | Indisponível | MPAA (link em japonês) |
Eslovênia (SI) | Indisponível | MPAA (link em japonês) |
África do Sul (África do Sul) | QPS | QPS |
Espanha (ES) | SETSI | ICAA |
Sri Lanka | Indisponível | Indisponível |
Suécia (SE) | Indisponível | SMSA (em inglês) |
Suíça (CH) | FSK (em inglês) | FSK (em inglês) |
Taiwan (Taiwan) | Indisponível | MOCTW (link em japonês) |
Tadjiquistão (TJ) | Indisponível | MKRF/RÚSSIA |
Tanzânia (TZ) | Indisponível | MPAA (link em japonês) |
Tailândia (TH) | Indisponível | BFVC (em inglês) |
Togo (TG) | Indisponível | CNC |
Trinidad e Tobago (TT) | Indisponível | Indisponível |
Turquia (TR) | RTCO | ECBMC (em inglês) |
Turcomenistão (TM) | Indisponível | MKRF/RÚSSIA |
Uganda (UG) | Indisponível | MPAA (link em japonês) |
Ucrânia (UA) | Indisponível | Indisponível |
Emirados Árabes Unidos (AE) | Indisponível | MPAA (link em japonês) |
Reino Unido (GB) | BBFC (link em inglês) | BBFC (link em inglês) |
Estados Unidos (EUA) | PG_PG | MPAA (link em japonês) |
Uruguai (UY) | Indisponível | MPAA (link em japonês) |
Uzbequistão (UZ) | Indisponível | MKRF/RÚSSIA |
Venezuela (VE) | Indisponível | RESORTEVIOLÊNCIA |
Vietnã (VN) | Indisponível | MCST (link em inglês) |
Zâmbia (ZM) | Indisponível | MPAA (link em japonês) |
Zimbábue (ZW) | Indisponível | MPAA (link em japonês) |
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 direta do Canadá
- Um ID da área de mercado designada (DMA): um identificador de uma região nos 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 URI. |
@type |
Texto | Obrigatório: sempre definido como GeoShape . |
addressCountry |
Texto | Obrigatório: o código ISO 3166-1 alfa-2 de duas letras. |
postalCode |
Texto | Opcional: lista de um ou mais códigos postais e/ou códigos da área de classificação direta (FSA, na sigla em inglês). |
identifier |
PropertyValue | Opcional: um ID da área designada do mercado (DMA), que é um identificador de uma região nos Estados Unidos, onde as pessoas recebem os mesmos canais e programas de televisão. |
identifier.@type |
Texto | Obrigatório: sempre definido como PropertyValue . |
identifier.propertyID |
Texto | Obrigatório: sempre definido como DMA_ID . |
identifier.value |
Texto | Obrigatório: o código 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 ordenaçã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"
}
]
}