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.contentRatingde "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"
}
]
}