Direitos de conteúdo: Conceitos básicos da entrega de EMA Avails

Categoria

Definição

Obrigatório

O seu título não será publicado sem esses campos para o tipo de conteúdo aplicável. Informar somente os campos obrigatórios resulta em uma experiência básica para o cliente.

Aprimorado

Esses campos não são obrigatórios para a publicação. Informá-los melhora a visibilidade, o posicionamento e a experiência do cliente.

Condicional

Este campo é obrigatório somente quando condições específicas são atendidas. A condição está indicada na descrição do campo. Se a condição se aplicar ao seu título, o campo passa a ser obrigatório.

Não usado

A Amazon não usa este campo. Você pode deixá-lo em branco.

Campo

Definição

Movie

Série/Temporada

Episódio

DisplayName

O seu PartnerAlias do Prime Video. Deve corresponder exatamente.

Obrigatório

Obrigatório

Obrigatório

Território

Código do país (ISO 3166-1) em que os direitos se aplicam.

Obrigatório

Obrigatório

Obrigatório

WorkType

Tipo de conteúdo: Movie, Season, Episode ou Supplemental.

Obrigatório

Obrigatório

Obrigatório

EntryType

Método de envio: Full Extract ou Full Delete.

Obrigatório

Obrigatório

Obrigatório

LicenseType

Modelo de direitos: SVOD, FVOD, EST, POEST ou VOD.

Obrigatório

Obrigatório

Obrigatório

FormatProfile

Qualidade do formato: SD, HD ou UHD.

Obrigatório

Obrigatório

Obrigatório

Start

Data de início da licença. Use o formato AAAA-MM-DD ou ISO 8601.

Obrigatório

Obrigatório

Obrigatório

ALID

ID lógica do ativo (EMA v1.7+). Vincula os direitos ao pacote de atendimento.

Obrigatório

Obrigatório

Obrigatório

Campo

Definição

Movie

séries

Temporada

Episódio

TitleInternalAlias

Título interno para identificação do filme ou do episódio.

Obrigatório

Não usado

Não usado

Obrigatório

SeriesTitleInternalAlias

Título interno da série. Compartilhado por todo o conteúdo da série.

Não usado

Obrigatório

Obrigatório

Obrigatório

SeasonTitleInternalAlias

Título interno da temporada. Usado em avails no nível da temporada.

Não usado

Não usado

Obrigatório

Não usado

SeasonNumber

Número da temporada (numérico). Obrigatório para avails no nível da temporada.

Não usado

Não usado

Obrigatório

Não usado

EpisodeNumber

Número do episódio na temporada (numérico).

Não usado

Não usado

Não usado

Obrigatório

EpisodeCount

Número total de episódios da temporada.

Não usado

Não usado

Obrigatório

Não usado

SeasonCount

Número total de temporadas da série.

Não usado

Aprimorado

Não usado

Não usado

Campo

Definição

VAM

Coleção

TitleInternalAlias

Título interno usado para identificação do VAM.

Obrigatório

Não usado

SeriesTitleInternalAlias

Título interno da série. Não se aplica a VAM nem a coleção.

Não usado

Não usado

EpisodeNumber

Não se aplica a conteúdo de VAM nem de coleção.

Não usado

Não usado

Campo

Definição

Movie

séries

Temporada

Episódio

ContentID

Identificador do filme ou do episódio para os metadados (EMA v1.7.x).

Obrigatório

Não usado

Não usado

Obrigatório

SeriesContentID

Identificador de conteúdo no nível da série. Obrigatório na v1.6; opcional na v1.7+.

Não usado

Obrig. na v1.6; opc. na v1.7+

Obrig. na v1.6; opc. na v1.7+

Obrig. na v1.6; opc. na v1.7+

SeasonContentID

Identificador de conteúdo no nível da temporada. Obrigatório na v1.6; opcional na v1.7+.

Não usado

Não usado

Obrig. na v1.6; opc. na v1.7+

Obrig. na v1.6; opc. na v1.7+

EpisodeContentID

Identificador de conteúdo no nível do episódio. Obrigatório na v1.6; opcional na v1.7+.

Não usado

Não usado

Não usado

Obrig. na v1.6; opc. na v1.7+

SeriesAltID

Identificador alternativo no nível da série. Obrigatório na v1.6; opcional na v1.7+.

Não usado

Obrig. na v1.6; opc. na v1.7+

Obrig. na v1.6; opc. na v1.7+

Obrig. na v1.6; opc. na v1.7+

SeasonAltID

Identificador alternativo no nível da temporada. Obrigatório na v1.6; opcional na v1.7+.

Não usado

Não usado

Obrig. na v1.6; opc. na v1.7+

Obrig. na v1.6; opc. na v1.7+

EpisodeAltID / AltID

ID interna do filme ou do episódio (EMA v1.6). Substituída pelo ALID na v1.7+.

Não usado

Não usado

Não usado

Obrig. na v1.6; opc. na v1.7+

Campo

Definição

Categoria

Condição

LicenseRightsDescription

Especifica o tipo de distribuição: SWP (produção na mesma semana) ou SDP (produção no mesmo dia).

Condicional

Obrigatório se não for conteúdo Library.

End

Data de término da licença. Deixe em branco para direitos sem data de término.

Condicional

Obrigatório se forem usadas instruções de horário. Deixe em branco para direitos sem data de término.

GroupIdentity

Nível de assinatura ou canal. Corresponde a ChannelIdentity na API.

Condicional

Obrigatório para Prime SVOD ou Canais. O seu arquivo será recusado se estiver presente em uma linha de tipo de licença TVOD ou FVOD.

Download

Habilita o download off-line para assinantes.

Obrigatório se for usado o recurso de download off-line.

BrandingRights

Habilita o posicionamento no carrossel Featured Originals and Exclusives.

Condicional

Obrigatório para o carrossel Featured Originals and Exclusives.

Exclusividade

Define os termos de exclusividade do título no Prime Video.

Aprimorado

Defina os termos de exclusividade quando aplicável.

Campo

Definição

Categoria

Quando é obrigatório

PriceType

Tipo de modelo de preço. Use NA, WSP, Tier ou Category.

Condicional

Obrigatório para todos os direitos de TVOD (EST/VOD). Não se aplica a SVOD.

PriceValue

Valor do preço ou código do nível. O formato deve corresponder ao valor de PriceType selecionado.

Condicional

Obrigatório para todos os direitos de TVOD (EST/VOD). O formato deve corresponder ao PriceType.

PriceCurrency

Código da moeda (ISO 4217) do valor do preço ou do SRP.

Condicional

Obrigatório quando o PriceType for WSP ou o SRP estiver preenchido.

SRP

Preço de varejo sugerido na moeda local. Somente valores numéricos.

Aprimorado

Opcional. Se preenchido, o PriceCurrency é obrigatório.

RentalDuration

Número de horas que o cliente tem para começar a assistir após o aluguel.

Condicional

Obrigatório para direitos de TVOD (VOD). Período de aluguel em horas; obrigatório para SVOD quando Download = Yes.

WatchDuration

Número de horas durante as quais o cliente pode assistir após o início da reprodução.

Condicional

Obrigatório para direitos de TVOD (VOD). Duração após o início da reprodução, em horas.

Campo

Definição

Categoria

Quando é obrigatório

SuppressionLiftDate

Define a data de início de EST visível para os clientes durante a janela de pré-venda.

Condicional

Obrigatório para POEST. Define a data de início de EST visível para os clientes.

AnnounceDate

Data em que a oferta de pré-venda fica visível para os clientes.

Aprimorado

Obrigatório para que as pré-vendas sejam exibidas quando o título for publicado.

SpecialPreOrderFulfillDate

Substituição opcional da data de atendimento da pré-venda. Deixe em branco para todos os outros tipos de licença.

Aprimorado

Opcional para pré-vendas. Deixe em branco para todos os outros tipos de licença.

Campo

Definição

Categoria

Quando é obrigatório

AssetLanguage

Idioma falado da faixa de áudio principal. Identifica o idioma do público-alvo.

Aprimorado

Idioma falado do público-alvo.

LocalizationType

Tipo de localização da oferta: sub, dub, subdub ou any.

Aprimorado

Em vez disso, o Prime Video recomenda acrescentar os modificadores diretamente em AllowedLanguages e HoldbackLanguage.

HoldbackLanguage

Códigos de idioma que não devem ser oferecidos neste território. Use códigos RFC 5646 com os modificadores opcionais :sub, :dub e :subdub.

Condicional

Obrigatório se você não quiser oferecer determinados idiomas em um território.

AllowedLanguages

Códigos de idioma permitidos neste território. Não pode ser usado com HoldbackLanguage no mesmo avail.

Condicional

Obrigatório se você quiser oferecer apenas determinados idiomas em um território.

RequiredFulfillmentLanguages

Códigos de idioma que devem estar presentes para que a oferta seja publicada. Se os ativos não estiverem disponíveis, a oferta não será publicada.

Condicional

Obrigatório se determinados idiomas forem necessários para que a oferta seja publicada.

Campo

Definição

Categoria

Quando é obrigatório

CaptionIncluded

Indica se o conteúdo inclui legendas ocultas.

Condicional

Obrigatório para conteúdo do território dos EUA.

CaptionExemption

Código de isenção quando não há legendas ocultas. Obrigatório se CaptionIncluded for false para conteúdo dos EUA.

Condicional

Obrigatório nos EUA se não houver legendas ocultas.

Campo do EMA

Campo da API (caminho completo)

Obrigatório

Condição

Observações/valores aceitos

Campos de identificação principais

DisplayName

Licensor.DisplayName

Sim

Deve corresponder ao PartnerAlias que o Prime Video atribuiu a você e ao mesmo valor usado nos seus arquivos EMA.

AssetLanguage / StoreLanguage

Transaction.AssetLanguage

Não

Campo direto, matriz. Código de idioma RFC 5646 mais o tipo de ativo. Tipos de ativo: subtitle, audio, subdub, sub, dub, ov, mta, any.

Território

Transaction.Territory[].country

Sim

Código ISO 3166-1 de duas letras. Um território por transação. O validador recusa mais de um território. Repita a transação para cada território.

WorkType

Asset.WorkType

Sim

Campo direto. Valores aceitos: Movie, Short, Episode, Season, Series, Supplemental, Collection, Excerpt.

EntryType

Disposition.EntryType

Sim

Campo direto. Valores aceitos: FullExtract, FullDelete.

TitleInternalAlias

Asset.Metadata.TitleInternalAlias (Movie, Short) or Asset.EpisodeMetadata.TitleInternalAlias (Episode)

Sim

Matriz com um único nome de título. Obrigatório para Movie, Short e Episode; o caminho depende do WorkType. Season usa SeasonTitleInternalAlias.

SeriesTitleInternalAlias

SeriesMetadata.SeriesTitleInternalAlias

Não

Opcional na API. Matriz com um único nome de título.

SeasonTitleInternalAlias

SeasonMetadata.SeasonTitleInternalAlias

Não

Opcional na API. Matriz com um único nome de título.

SeasonNumber

SeasonMetadata.SeasonNumber

Condicional

WorkType = Episode ou Season

Número inteiro. Obrigatório para conteúdo episódico.

EpisodeNumber

EpisodeMetadata.EpisodeNumber

Condicional

WorkType = Episode

Número inteiro. Obrigatório para envios no nível do episódio.

Campos de licença e direitos

LicenseType

Transaction.LicenseType

Sim

Campo direto. Valores aceitos: SVOD, FVOD, EST, POEST, VOD. Não há valor TVOD nem AVOD. Todas as transações de um avail devem compartilhar a mesma linha de negócios.

LicenseRightsDescription

Transaction.LicenseRightsDescription

Não

Campo direto. Valores aceitos: DAB, POD, JAB, STAB, SWP, SDP, PVOD, New Release. “Library” é aceito, mas descartado. Qualquer outro valor é recusado.

FormatProfile

Transaction.FormatProfile

Sim

Campo direto. Valores aceitos: SD, HD, UHD. “4K” é recusado; envie como UHD.

Start

Transaction.Start

Sim

Campo direto. Data e hora ISO 8601, por exemplo, 2027-01-01T00:00:00. Se nenhum fuso horário for incluído, será usado o fuso horário mais a leste do território.

End

Transaction.End

Não

Campo direto. Data e hora ISO 8601. Omita para janelas sem data de término.

Campos de duração e contagem

RentalDuration

Transaction.Terms[] _termName = “RentalDuration” (Duration)

Condicional

Somente SVOD quando Download = Yes

Term, e não um campo direto. Duração ISO 8601 em horas inteiras, PT{N}H. Exemplo: PT48H.

WatchDuration

Transaction.Terms[] _termName = “WatchDuration” (Duration)

Condicional

Somente SVOD quando Download = Yes

Term, com a mesma estrutura do RentalDuration. Formato PT{N}H.

EpisodeCount / NumberOfEpisodes

SeasonMetadata.NumberOfEpisodes

Condicional

WorkType = Season (sempre que SeasonMetadata for enviado)

Número inteiro. Obrigatório em SeasonMetadata.

SeasonCount / NumberOfSeasons

SeriesMetadata.NumberOfSeasons

Não

Número inteiro. Metadados opcionais para registros no nível da série.

Campos de ID exclusiva

ALID

ALID

Sim

Obrigatório na API. O ALID deve ser idêntico a Asset._contentID. O validador recusa uma divergência.

EpisodeContentID / ContentID

Asset._contentID

Sim

Campo direto no objeto Asset. Deve ser idêntico ao ALID; o validador recusa uma divergência.

SeriesAltID

SeriesMetadata.SeriesContentID

Condicional

WorkType = Episode ou Season

Mesmo campo que SeriesContentID; não há um SeriesAltID separado na API.

SeasonAltID

SeasonMetadata.SeasonContentID

Condicional

WorkType = Episode ou Season

Mesmo campo que SeasonContentID; não há um SeasonAltID separado na API.

SeriesContentID

SeriesMetadata.SeriesContentID

Condicional

WorkType = Episode ou Season

Obrigatório para envios de episódios. Identifica a série à qual pertence.

SeasonContentID

SeasonMetadata.SeasonContentID

Condicional

WorkType = Episode ou Season

Obrigatório para envios de episódios. Identifica a temporada à qual pertence.

EpisodeAltID / AltID

ALID

Sim

Mesmo campo que ALID; não há um AltID separado na API. Deve ser idêntico a Asset._contentID.

Campos de assinatura, canal e contrato

GroupIdentity

Transaction.Terms[] _termName = “ChannelIdentity” (Text)

Condicional

Somente Prime SVOD e Canais

Term, e não um campo direto. Obrigatório para Prime SVOD e Canais. Deve estar ausente para TVOD e FVOD (uma transação TVOD ou FVOD com ChannelIdentity é recusada). O valor é o identificador do canal ou da assinatura que o Prime Video atribuiu a você; não é uma lista fixa.

ContractID

Transaction.ContractID

Não

Campo direto, escrito na Transaction, e não dentro de Terms[]. Valores aceitos: CPH, FIXED_FEE ou FIXED_FEE:{Deal ID}.

Download

Transaction.Terms[] _termName = “Download” (Text)

Não

Term, e não um campo direto. Valores aceitos: Yes, No. Definir Yes em uma transação SVOD aciona a exigência de RentalDuration e WatchDuration.

Exclusivity / Exclusive

Transaction.Terms[] _termName = “Exclusive” (Boolean)

Não

Term. Valores aceitos: true, false. Quando true, envie também ExclusiveAttributes; caso contrário, será aplicado um valor padrão.

ExclusiveAttributes

Transaction.Terms[] _termName = “ExclusiveAttributes” (Text)

Condicional

Somente quando Exclusive = true

Term. Um valor padrão é aplicado se for omitido. Valores aceitos: FIRST_RUN, FIRST_RUN_EXCLUSIVE, SECOND_RUN, CURRENT_TV, LIBRARY_TV, KIDS_TV, PAY_ONE, PAY_TWO, DTV, LIBRARY_MOVIE, KIDS_MOVIE, DTS_MOVIE, NEW_RELEASE, LIBRARY, MEGA_LIBRARY, PRIORITY_LIBRARY, DD_THEATRICAL, PRE_THEATRICAL, EARLY_EST, EARLY_VOD, PREORDER_EST, PREORDER_VOD.

Campos de pré-venda

SuppressionLiftDate

Transaction.Terms[] _termName = “SuppressionLiftDate” (Event)

Condicional

Obrigatório quando LicenseType = POEST

Term. Data e hora ISO 8601. Especifica quando a supressão do conteúdo em pré-venda é retirada.

AnnounceDate

Transaction.Terms[] _termName = “AnnounceDate” (Event)

Não

Term. Data e hora ISO 8601. Use para indicar a data do seu anúncio público.

Campos de idioma e localização

HoldbackLanguage

Transaction.HoldbackLanguage

Não

Campo direto, matriz. Código de idioma RFC 5646 mais o tipo de ativo. Tipos de ativo: legenda, áudio, sub, dub, subdub, nenhum.

HoldbackExclusionLanguage / AllowedLanguages

Transaction.AllowedLanguage

Não

Campo direto, matriz. Código de idioma RFC 5646 mais o tipo de ativo. Tipos de ativo: legenda, áudio, sub, dub, subdub, nenhum. Não pode ser combinado com HoldbackLanguage na mesma transação.

Campos de preço

PriceType

Transaction.Terms[]._termName

Condicional

Obrigatório para VOD, EST, POEST

O valor de PriceType do EMA se torna o nome do term. Nomes de term aceitos: SRP, WSP (Money), Tier, Category (Text). Um term de preço é obrigatório para VOD, EST e POEST.

PriceValue

atributo value dentro de Money ou Text

Condicional

Obrigatório para VOD, EST, POEST

Para SRP ou WSP: decimal positivo maior que 0 dentro do valor Money. Para Tier ou Category: valor em texto desse term.

PriceCurrency

atributo _currency dentro de Money

Condicional

Obrigatório ao usar SRP ou WSP

Código de moeda ISO 4217. É um atributo dentro do valor Money, e não um campo independente. Exemplo: {"_termName": “SRP”, “Money": {"_currency": “GBP”, “value": “9.99"}}.

SRP

Transaction.Terms[] _termName = “SRP” (Money)

Condicional

Obrigatório para VOD, EST, POEST

Term. SRP é um nome de term, e não uma moeda. O atributo _currency fica dentro do valor Money.

Campos de marketing e conformidade

BrandingRights

Transaction.Terms[] _termName = “BrandingRights” (Boolean)

Não

Term. Valores aceitos: true, false.

BrandingRightsAttributes

Transaction.Terms[] _termName = “BrandingRightsAttributes” (Text)

Não

Somente quando BrandingRights = true

Term. Texto livre; um valor padrão é aplicado se for omitido.

Campos de rastreamento e opcionais

AvailID

Transaction._TransactionID

Não

Campo direto. Opcional. Deve ser exclusivo no avail; duplicatas são recusadas.

RetailerSpare2 / AdKey

RetailerSpare2

Não

OtherInstructions

Transaction.OtherInstructions

Não

Campo direto. Texto livre. Use para quaisquer instruções de entrega não cobertas por outros campos.

DMA_ID / EcosystemID

SharedEntitlement.EcosystemID

Não

Campo direto na entrada SharedEntitlement do avail, com SharedEntitlement._ecosystem = “DMA”. Identificador do título específico do ecossistema.

Campos exclusivos da API (sem equivalente no EMA)

N/A

Transaction.Terms[] _termName = “allowAds” (Boolean)

Não

Sem equivalente no EMA. Valores aceitos: true, false. Habilita a publicidade na transação.

N/A

Transaction.Terms[] _termName = “allowedAdPlacement” (Text)

Condicional

Somente quando allowAds = true; apenas um entre allowedAdPlacement e prohibitedAdPlacement por transação

Valores aceitos: PreRoll, MidRoll, PostRoll, Overlays, PauseAds, Squeezebacks.

N/A

Transaction.Terms[] _termName = “prohibitedAdPlacement” (Text)

Condicional

Somente quando allowAds = true; apenas um entre allowedAdPlacement e prohibitedAdPlacement por transação

Valores aceitos: PreRoll, MidRoll, PostRoll, Overlays, PauseAds, Squeezebacks.

N/A

Transaction.Terms[] _termName = “cuepointDeliveryAndUsage” (Text)

Condicional

Somente quando allowAds = true

Valores aceitos: PartnerWillDeliverAndPrimeVideoMustUse, PrimeVideoWillUseIfDelivered, NoDeliveryOrUsageObligations, TalentObligated.

Sem suporte na API

Descrição

Sem suporte

N/A

A API não aceita um campo Description. Use a entrega de metadados para o conteúdo descritivo.

WindowDuration

Sem suporte

N/A

A duração da janela é expressa por meio das datas de Start e End. Envie esses campos no lugar dele.

SpecialPreOrderFulfillDate

Sem suporte

N/A

Sem equivalente na API. Não é enviado por meio da API de Avails.

ReleaseYear

Sem suporte

N/A

Sem equivalente na API. Entregue por meio dos metadados, e não da API de Avails.

RequiredFulfillmentLanguages

Sem suporte

N/A

Sem equivalente na API.

CaptionIncluded

Sem suporte

N/A

Sem equivalente na API; a conformidade das legendas ocultas é tratada no lado do ativo.

CaptionExemption

Sem suporte

N/A

Sem equivalente na API; a conformidade das legendas ocultas é tratada no lado do ativo.

ServiceProvider

Sem suporte

N/A

Sem equivalente na API.

ExceptionFlag

Sem suporte

N/A

Sem equivalente na API.

SeriesTitleDisplayUnlimited

Sem suporte

EpisodeTitleDisplayUnlimited / TitleDisplayUnlimited

Sem equivalente na API. Os títulos de exibição vêm dos metadados do título; o avail identifica o título pelo ALID.

N/A

Sem suporte

N/A

Sem equivalente na API.

SeasonTitleDisplayUnlimited

Sem suporte

N/A

Sem equivalente na API.

TitleStatus

Sem suporte

N/A

Sem equivalente na API.

SeriesID

Sem suporte

N/A

Sem equivalente na API.

SeasonID

Sem suporte

N/A

Sem equivalente na API.

EpisodeTitleID / TitleID

Sem suporte

N/A

Sem equivalente na API.

EpisodeID / EditID

Sem suporte

N/A

Sem equivalente na API.

UV_ID

Sem suporte

N/A

Sem equivalente na API.