La API de Prime Video Avils forma parte del paquete de API de contenido y te permite gestionar la disponibilidad de tus títulos en Prime Video mediante la integración directa con tus sistemas de gestión de derechos de contenido. Enviar, actualizar, recuperar o eliminar las ventanas de disponibilidad con mayor precisión y control que las cargas de archivos tradicionales.
¿Por qué usar la API Avils?
La API agiliza el flujo de trabajo de administración de contenido y te da más control sobre tu catálogo de Prime Video:
- Administración automatizada: elimina las cargas manuales y reduce los errores automatizando los envíos y actualizaciones de los períodos de disponibilidad, lo que permite a tu equipo centrarse en tareas estratégicas
- Mayor eficiencia: actualice los períodos de disponibilidad específicos sin tener que volver a enviar conjuntos de datos completos, lo que ahorra tiempo y reduce el procesamiento redundante.
- Comentarios directos: valide sus datos en tiempo real y reciba mensajes de error inmediatos sin necesidad de iniciar sesión en Slate para realizar correcciones manuales.
- Interoperabilidad: se basa en una interfaz REST que es independiente del idioma, el sistema y la plataforma, a la que se puede acceder desde cualquier sistema con conexión a Internet.
Operaciones y puntos finales de la API
Todos los puntos finales son independientes del idioma y se puede acceder a ellos mediante HTTP 1.1 desde cualquier sistema con conexión a Internet. Los puntos finales de Avils no siguen un protocolo específico y se pueden llamar en cualquier orden en función de las necesidades del flujo de trabajo.
Acerca de los modelos de extracción
Un modelo de extracción define la forma en que se estructuran y envían los datos de disponibilidad a Prime Video. Imagínelo como elegir entre enviarnos la información completa de su catálogo o enviarnos solo los cambios específicos que necesita realizar.
Operación 1: Crear/actualizar Avails
- Qué hace: Añade nuevas ventanas de disponibilidad o actualiza las existentes para tus títulos.
- Por qué lo necesitas: así es como le dices a Prime Video cuándo y dónde tu contenido debe estar disponible para los clientes. Tanto si vas a lanzar contenido nuevo como a ampliar una licencia existente, esta operación garantiza que tus datos de disponibilidad estén actualizados.
Operación 3: Validate Avils
- Qué hace: Comprueba si hay errores en los datos de disponibilidad antes de enviarlos a los sistemas en directo de Prime Video.
- Por qué lo necesitas: detecta los errores de formato, la falta de campos obligatorios o las infracciones de las normas empresariales antes de que afecten a la disponibilidad del contenido. Esto ahorra tiempo al eliminar la necesidad de enviarlos, esperar a que se procesen, corregir los errores y volver a enviarlos.
Operación 4: Delete Avils
- Qué hace: elimina las ventanas de disponibilidad de los sistemas de Prime Video.
- Por qué lo necesita: Gestione situaciones puntuales en las que la disponibilidad deba eliminarse por completo en lugar de caducar.
- Importante: Recomendamos encarecidamente que el contenido caduque ajustando la fecha de finalización en lugar de eliminarlo, excepto en casos de uso puntual. Al expirar se mantienen los datos históricos y el registro de auditoría.
Códigos de respuesta HTTP
Todos los puntos de conexión de Avails devuelven códigos HTTP estándar que indican si la solicitud de API se ha realizado correctamente o no y si los errores son temporales (se pueden volver a intentar) o permanentes, lo que permite al sistema gestionar automáticamente las respuestas sin intervención manual.
Código HTTP |
Description |
Reintentable |
200 |
La llamada a la API se realizó correctamente. Las personas que llamen deben comprobar el objeto de respuesta para obtener más detalles. |
N/A |
400 |
Solicitud errónea, incluidos errores de validación. |
No |
401 |
No autorizado. |
No |
404 |
No se encuentra. |
No |
500 |
Error interno. |
Sí |
503 |
Error de dependencia. |
Sí |
Nota: En el caso de los errores que se puedan volver a intentar (500, 503), implemente la lógica de reintento con los retrasos adecuados entre los intentos. Los errores que no se pueden volver a intentar (400, 401, 404) indican problemas en la solicitud que deben corregirse antes de volver a enviarlos.
Esquemas de API
Los esquemas descritos en esta documentación están diseñados para ayudar a los desarrolladores a integrarse con la API Avils. Todos los esquemas de carga útil cumplen con el estándar MDDF API v2.6. Si bien puedes incluir cualquier atributo de la API v2.6 de MDDF en tu carga útil, Prime Video solo procesa los atributos compatibles; los atributos no compatibles se ignorarán.
Nota: Para obtener una referencia completa de los atributos admitidos que coinciden con nuestra especificación de disponibilidad de EMA, consulta la columna de disponibilidad de la EMA en la tabla de tipos de datos principales que aparece a continuación. Para obtener información sobre cómo se administran y utilizan las disponibilidades en Prime Video, consulta la página de derechos de contenido.
Conversión de XML de MDDF a JSON
La API de MDDF Avails define su esquema en formato XML, pero admite cargas útiles tanto en XML como en JSON. Las API de Prime Video Avails utilizan cargas útiles codificadas en JSON.El proceso para convertir XML de MDDF a JSON se describe a continuación: se omiten los espacios de nombres
<alice>bob</alice>
becomes
{ "alice": "bob" }
Los elementos anidados se convierten en propiedades anidadas
<alice><bob>charlie</bob><david>edgar</david></alice>
becomes
{ "alice": { "bob": "charlie", "david": "edgar" } }
Varios elementos con el mismo nombre se convierten en elementos de matriz
<alice><bob>charlie</bob><bob>david</bob></alice>
becomes
{ "alice": { "bob": [ "charlie", "david" ] } }
Los atributos aparecen en las propiedades y van precedidos de un guión bajo
<alice charlie="david">bob</alice>
becomes
{ "alice": { "_charlie": "david", "value": "bob" } }
Tipos de datos de esquema comunes
El esquema de la API Avils admite los siguientes tipos de datos:
| Type |
Description |
| Booleano |
De tipo booleano. Valores permitidos: verdadero, falso |
| Entero |
Entero con signo de 32 bits. |
| Número entero largo |
Entero con signo de 64 bits. |
| Decimal |
Número de coma flotante. |
| Cadena |
Un conjunto de caracteres. |
| Marca de tiempo |
Marca de tiempo ISO. |
| Enum |
Una cadena enumerada con un conjunto predefinido de valores permitidos. |
| Estructura |
La estructura sirve como agregador de otros atributos. |
| Matriz |
Colección de artículos de tipo ASME. Designado por []. |
Nota: La cantidad máxima de artículos permitida en las solicitudes por lotes está limitada a 100.
Esquemas de solicitud y respuesta
En esta sección se definen las estructuras de datos para todas las operaciones de la API de Avils. Estos esquemas especifican el formato exacto de las solicitudes que envías a Prime Video y las respuestas que recibes. Comprender estas estructuras es esencial para una integración exitosa de las API.
Esquema 1: Crear/actualizar Avails
Estos esquemas definen la estructura para crear o actualizar las ventanas de disponibilidad en el sistema de Prime Video. Úselos cuando necesite enviar nuevos derechos de contenido o modificar los existentes.
PutAvailSapiRequest
type Este es el objeto de solicitud principal para enviar una ventana de disponibilidad única.
Atributo |
Type |
Es obligatorio |
Description |
aprovechar |
Aprovechar |
Sí |
Datos de disponibilidad: este es el atributo de nivel superior de cualquier solicitud de colocación o validación |
PutAvailSapiResponse
type La respuesta
que recibirá después de enviar un período de disponibilidad. Marque el campo de éxito para confirmar que la operación se completó y revise los errores si el envío no se realizó correctamente.Atributo |
Type |
Es obligatorio |
Description |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
PutAvailsBatchapiRequest
type Use este esquema cuando necesite enviar varias ventanas de disponibilidad en una sola llamada a la API. Las operaciones por lotes mejoran la eficiencia a la hora de gestionar catálogos grandes o realizar actualizaciones masivas.
Atributo |
Type |
Es obligatorio |
Description |
Artículos de solicitud |
Pon un objeto de solicitud por lotes [] |
Sí |
Lista de solicitudes individuales |
PutAvailsBatchapiResponse
type La respuesta por lotes devuelve resultados individuales para cada artículo de la solicitud de lote. Cada elemento de respuesta corresponde a un elemento de solicitud a través del RequestItemID.
Atributo |
Type |
Es obligatorio |
Description |
Elementos de respuesta |
Pon un objeto de respuesta por lotes [] |
Sí |
Lista de elementos de respuesta |
Tipo
PutAvailsBatchaPiRequestItem Cada elemento de una solicitud por lotes requiere un identificador y una ruta únicos que especifiquen el tipo de operación (Full Extract) y el recurso de destino.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote. Se trata de una cadena única que utilizarás para identificar cada artículo del lote y que se vinculará a nuestra respuesta al lote. |
camino |
Cadena |
Sí |
Ruta a un recurso para este elemento solicitado. |
cuerpo |
Pon a VailsBatch en el cuerpo de la solicitud |
Sí |
Datos de disponibilidad |
PutAvailsBatchapiRequestItemBody
type El cuerpo de cada elemento de solicitud de lote contiene los datos de disponibilidad reales que estás enviando.
Atributo |
Type |
Es obligatorio |
Description |
aprovechar |
Aprovechar |
Sí |
Datos de disponibilidad |
PutAvailsBatchaPIResponseItem
type Cada elemento de respuesta del lote indica que la solicitud correspondiente se ha realizado correctamente o no. Use el RequestItemID para hacer coincidir las respuestas con las solicitudes originales.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
Esquema 2: Retrieve Avails
Estos esquemas definen cómo recuperar las ventanas de disponibilidad existentes del sistema de Prime Video. Úselos para consultar la información sobre los derechos actuales de su contenido.
GetAvailsApiResponse
type La respuesta contiene todos los datos de disponibilidad del contenido solicitado, incluidos todos los términos de licencia y los derechos territoriales.
Atributo |
Type |
Es obligatorio |
Description |
aprovechar |
Aprovechar |
Sí |
Datos de disponibilidad |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
getAvailsBatchapiRequest
Recupera varias ventanas de disponibilidad en una sola llamada a la API. Esto resulta eficaz cuando se necesitan comprobar los derechos de varios títulos o transacciones.
Atributo |
Type |
Es obligatorio |
Description |
Artículos de solicitud |
GetAvailsBatchApi Request Item [] |
Sí |
Lista de solicitudes individuales |
GetAvailsBatchapiResponse
Devuelve los datos de disponibilidad de cada artículo solicitado. Cada respuesta corresponde a una solicitud a través del RequestItemID.
Atributo |
Type |
Es obligatorio |
Description |
Elementos de respuesta |
GetAvailsBatchApiResponseItem [] |
Sí |
Lista de elementos de respuesta |
getAvailsBatchapiRequestItem
Cada elemento de solicitud de obtención especifica la ruta al recurso que se quiere recuperar.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote |
ruta |
Cadena |
Sí |
Ruta a un recurso para este elemento solicitado. |
getAvailsBatchapiResponseItem
Cada elemento de respuesta contiene los datos de disponibilidad si la recuperación se realizó correctamente o los detalles del error si no se pudo.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
aprovechar |
Aprovechar |
No |
Aprovechar el objeto |
Esquema 3: Validate Avils
Estos esquemas te permiten probar tus datos de disponibilidad antes de enviarlos al sistema de Prime Video. La validación detecta los errores de forma temprana sin crear ni modificar los períodos de disponibilidad reales.
ValidateAvailsAPIRequest
type La respuesta de validación indica si los datos cumplen todas las reglas de validación. Revise cualquier error antes de enviar la solicitud de creación o actualización propiamente dicha.
Atributo |
Type |
Es obligatorio |
Description |
aprovechar |
Aprovechar |
Sí |
Datos de disponibilidad |
ValidateAvailsAPIResponse
type La respuesta de validación indica si los datos cumplen todas las reglas de validación. Revise cualquier error antes de enviar la solicitud de creación o actualización propiamente dicha.
Atributo |
Type |
Es obligatorio |
Description |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
ValidateAvailsBatchapiRequest
type Valide varias ventanas de disponibilidad en una sola llamada. Esto resulta especialmente útil cuando se preparan envíos de lotes grandes.
Atributo |
Type |
Es obligatorio |
Description |
Artículos de solicitud |
Validate AvailsBatchApi RequestItem [] |
Sí |
Lista de solicitudes individuales |
ValidateAvailsBatchapiResponse
type Devuelve los resultados de la validación de cada artículo del lote. Cada respuesta corresponde a un elemento de solicitud mediante el RequestItemID.
Atributo |
Type |
Es obligatorio |
Description |
Elementos de respuesta |
ValidateAvailsBatchApiResponseItem [] |
Sí |
Lista de elementos de respuesta |
ValidateAvailsBatchapiRequestItem
type Cada elemento de la solicitud de validación incluye la ruta del recurso con /validate adjunto para distinguirla de las operaciones reales de creación o actualización.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote |
ruta |
Cadena |
Sí |
Ruta a un recurso para la solicitud: modelo |
cuerpo |
Validate AvailsBatchApi RequestItemBody |
Sí |
Órgano de solicitud |
ValidateAvailsBatchapiRequestItemBody type Contiene los datos de la ventana de disponibilidad que se van a validar.
Atributo |
Type |
Es obligatorio |
Description |
aprovechar |
Aprovechar |
Sí |
Datos de disponibilidad |
ValidateAvailsBatchapiResponseItem
type Cada elemento de respuesta de validación muestra si los datos correspondientes han pasado las comprobaciones de validación.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
Esquema 4: Delete Avils
Estos esquemas definen cómo eliminar las ventanas de disponibilidad del sistema de Prime Video.
Importante: Recomendamos encarecidamente que el contenido caduque ajustando la fecha de finalización en lugar de eliminarlo, excepto en casos de uso específicos, como los relacionados con los requisitos de conformidad. El contenido que caduca conserva sus datos históricos y su registro de auditoría, lo que resulta valioso para la elaboración de informes y la conciliación.
El
tipo DeleteAvailsAPIResponse confirma si la operación de eliminación se ha completado correctamente. Marque el campo de éxito y revise los errores.
Atributo |
Type |
Es obligatorio |
Description |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
DeleteAvailsBatchapiRequest
type Elimina varias ventanas de disponibilidad en una sola llamada a la API. Esto resulta útil para eliminaciones masivas o vencimientos de derechos.
Atributo |
Type |
Es obligatorio |
Description |
Artículos de solicitud |
Eliminar un elemento de solicitud de API por lotes disponible [] |
Sí |
Lista de solicitudes individuales |
DeleteAvailsBatchapiResponse
type Devuelve los resultados de eliminación de cada elemento de la solicitud de lote.
Atributo |
Type |
Es obligatorio |
Description |
Elementos de respuesta |
Eliminar el elemento de respuesta de API por lotes disponible [] |
Sí |
Lista de elementos de respuesta. |
DeleteAvailsBatchaPiRequestItem
type Cada elemento de solicitud de eliminación especifica la ruta al recurso que se va a eliminar.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote |
ruta |
Cadena |
Sí |
Ruta a un recurso para este elemento solicitado. |
DeleteAvailsBatchaPIResponseItem
type Cada elemento de respuesta confirma si la eliminación se realizó correctamente para la solicitud correspondiente.
Atributo |
Type |
Es obligatorio |
Description |
ID del artículo de solicitud |
Cadena |
Sí |
Identificador único del artículo en la solicitud de lote |
éxito |
booleano |
Sí |
Estado de la operación |
errores |
Error [] |
No |
Lista de errores en caso de fallo |
Tipos de datos básicos
Estos tipos de datos fundamentales se utilizan en todos los esquemas de API. Comprender estas estructuras es esencial para trabajar con cualquier operación disponible. Para obtener más información, consulta la página de derechos de contenido.
Tipo de error: Estructura de error
estándar devuelta cuando las operaciones fallan. El código identifica el tipo de error, mientras que el mensaje proporciona detalles legibles por humanos.
Atributo |
Type |
Es obligatorio |
Description |
código |
Cadena |
Sí |
Cadena que describe el tipo de error. |
mensaje |
Cadena |
Sí |
Descripción del error legible por humanos |
Avail type
La estructura de datos principal que representa una ventana de disponibilidad completa. Esto incluye toda la información sobre los derechos de contenido, los términos de licencia, los territorios y las condiciones comerciales.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
VÁLIDO |
Cadena |
Sí |
Especifica el identificador del título. Debe coincidir con el ALID especificado en la contribución de metadatos. |
VÁLIDO |
Disposición |
Disposición disponible |
Sí |
Especifica la granularidad del modelo de extracción. |
N/A |
Licenciante |
Publicador |
Sí |
Especifica información sobre la entidad que concede la licencia a Prime Video. |
N/A |
Activo |
Activo disponible [] |
Sí |
Información sobre el activo. Solo se debe especificar un activo en la lista. |
N/A |
Transacción |
AvailTrans [] |
Sí |
Información sobre la transacción. |
N/A |
Derecho compartido |
Derecho compartido disponible [] |
No |
Información sobre los derechos a otros servicios. |
N/A |
El tipo AvailDisposition define si se trata de una operación Full Extract o Full Delete y si se trata de crear/actualizar o eliminar datos.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
EntryType |
Enum |
Sí |
Valores permitidos: FullExtract, FullDelete |
Disposición |
El tipo de publicador
identifica a su organización como licenciante del contenido. Prime Video proporciona este valor durante la incorporación.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
DisplayName |
Cadena |
Sí |
Especifica el nombre del socio de Prime Video. Prime Video proporcionará este valor a los socios. Debe tener el mismo valor que el utilizado en los archivos EMA. |
DisplayName |
AvailAsset type
Describe el activo de contenido que se va a licenciar. La estructura varía según el WorkType (Película, Episodio, Temporada, etc.).
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
_ContentID |
Cadena |
Sí |
Especifica el ID de contenido de este recurso. Por lo general, es igual que ALID. |
ContentID |
WorkType |
Enum |
Sí |
Valores permitidos: Película, Cortometraje, Episodio, Temporada, Complementario |
WorkType |
Metadatos |
Metadatos de la unidad disponibles |
Condicional |
Describe los metadatos de una película o un cortometraje. Obligatorio cuando WorkType es película o cortometraje. |
N/A |
Metadatos del episodio |
Disponibilidad de los metadatos del episodio |
Condicional |
Describe los metadatos del episodio. Obligatorio cuando WorkType es Episode. |
N/A |
Metadatos de temporada |
Metadatos de temporada disponibles |
Condicional |
Describe los metadatos de la Temporada. Obligatorio cuando WorkType es Temporada. |
N/A |
AvailSharedEntitlement
type Especifica los derechos de otros ecosistemas digitales, como DMA (Digital Movie Alliance).
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
_ecosistema |
Enum |
Sí |
Valores permitidos: DMA |
N/A |
ID de ecosistema |
Cadena |
Sí |
Identificador de título específico del ecosistema |
DMA_ID |
AvailUnitMetadata type Metadata:
metadatos para contenido independiente, como películas o cortos.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
Alias internas del título |
Cadena [] |
Sí |
Nombre del título. Solo se debe especificar un nombre de título en la lista. |
TitleInternalAlias |
Metadata de
AvailEpisodeMetadata: metadatos específicos de los episodios de TV, incluidos el número de episodio y la información principal de la temporada o serie.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
Alias internas del título |
Cadena [] |
Sí |
Nombre del título del episodio. Solo se debe especificar un nombre de título en la lista. |
EpisodeTitleInternalAlias |
Episode Number |
Información de secuencia de contenido |
Sí |
Number de este episodio dentro de la temporada. |
EpisodeNumber |
Metadatos de temporada |
Metadatos de temporada disponibles |
Condicional |
Describe los metadatos de la Temporada. Obligatorio cuando WorkType es Episodio o Temporada. |
N/A |
Metadata de la serie |
Metadatos de serie disponibles |
Condicional |
Describe los metadatos de la Serie. Obligatorio cuando WorkType es Episodio o Temporada. |
N/A |
AvailSeasonMetadata:
metadatos para temporadas de TV, incluidos el número de temporada y el recuento de episodios.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
SeasonContentiD |
Cadena |
Sí |
ALID para la temporada. |
SeasonContentID |
Título de la temporada: Internal Alias |
Cadena [] |
No |
Nombre del título de la temporada. Solo se debe especificar un nombre de título en la lista. |
SeasonTitleInternalAlias |
Season Number |
Información de secuencia de contenido |
Sí |
Number de esta temporada dentro de la serie. |
SeasonNumber |
Número de episodios |
Entero |
Sí |
Number of episodes in this season. |
EpisodeCount |
Metadatos de la serie |
Metadatos de serie disponibles |
Condicional |
Describe los metadatos de la Serie. Obligatorio cuando WorkType es Temporada. |
N/A |
AvailSeriesMetadata type
Metadata para series de TV, que proporcionan la información de serie de nivel superior.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
ID de contenido de la serie |
Cadena |
Sí |
ALID para series. |
ID de contenido de la serie |
Nombre de la serie Internalalias |
Cadena [] |
No |
Nombre del título de la Serie. Solo se debe especificar un nombre de título en la lista. |
Nombre de la serie Internalalias |
Número de temporadas |
Entero |
No |
Number of seasons in this series. |
SeasonCount |
El tipo AvailTrans define una transacción de licencia específica, que incluye el territorio, las fechas, el tipo de licencia y las condiciones comerciales. Aquí es donde se especifican los derechos reales que se van a conceder.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
_ID de transacción |
Cadena |
No |
Identificador único para la ventana de disponibilidad. Opcional cuando se utiliza FullExtract. |
AvailID |
LicenseType |
Enum |
Sí |
Valores permitidos: SVOD, FVOD, EST, POEST, VOD |
LicenseType |
Territorio |
Region [] |
Sí |
Territorio donde se permite la distribución. Solo se debe proporcionar un elemento de territorio. Todas las transacciones dentro de un único objeto Avail deben tener el mismo territorio. |
Territorio |
Start |
Fecha y hora |
Sí |
Fecha y hora de inicio de la distribución en formato ISO. NOTA: Si no se incluye ninguna zona horaria, utilizaremos la zona horaria más oriental de la región. Sin embargo, puedes incluir cualquier zona horaria si quieres una hora de lanzamiento específica. |
Start |
End |
Fecha y hora |
No |
Fecha y hora de finalización de la distribución en formato ISO. Si no se proporciona, la distribución tiene una duración ilimitada. NOTA: Si no se incluye ninguna zona horaria, utilizaremos la zona horaria más oriental de la región. Sin embargo, puedes incluir cualquier zona horaria si quieres una hora de retirada específica. |
End |
AssetLanguage |
AssetLanguage [] |
No |
El idioma del activo se expresa como código de idioma ISO con el tipo de activo. Tipos de recursos permitidos: subtítulos, audio, subdub, sub, dub, ov, mta, cualquiera |
AssetLanguage |
AllowedLanguage |
AssetLanguage [] |
No |
Código de lenguaje ISO con tipo de activo. Tipos de recursos permitidos: subtítulo, audio, sub, dub, subdub, cualquier |
Idiomas permitidos |
Holdback Language |
AssetLanguage [] |
No |
Código de lenguaje ISO con tipo de activo. Tipos de recursos permitidos: subtítulo, audio, sub, dub, subdub, cualquier |
HoldbackLanguage |
Descripción de LicenserightsDescription |
Cadena |
No |
Se utiliza para especificar la prioridad de publicación. |
LicenseRightsDescription |
FormatProfile |
AvailFormatProfile |
Sí |
Calidad del vídeo disponible. Valores permitidos: SD, HD, UHD |
FormatProfile |
ContractiD |
Cadena |
No |
Especifica la información contractual. Valores permitidos: |
ContractID |
Términos |
Términos disponibles [] |
Sí |
Especifica la lista de términos comerciales para la ventana de disponibilidad. |
OtherTerms |
Other Instructions |
Cadena |
No |
Instrucciones de procesamiento adicionales para la ventana de disponibilidad. |
OtherInstructions |
Region type
Especifica un territorio geográfico mediante los códigos de país ISO.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
country |
Cadena |
Sí |
Código de país ISO 3166-1 de 2 letras |
N/A |
AssetLanguage
type Define la disponibilidad del idioma para los recursos de audio y subtítulos.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
valor |
Cadena |
Sí |
El idioma del activo se expresa como código de idioma RFC 5646 con el tipo de activo. |
N/A |
_activo |
Cadena |
No |
Se permite un conjunto diferente de valores, según el atributo language del tipo AvailTrans. |
N/A |
AvailFormatProfile type
Especifica el nivel de calidad de vídeo para la disponibilidad.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
valor |
Enum |
Sí |
Calidad del vídeo disponible. Valores permitidos: SD, HD, UHD |
N/A |
Tipo
AvailTerms Estructura flexible para especificar términos comerciales. Cada término tiene un nombre y un valor del tipo correspondiente (Money, Text, Event, Boolean, Duration o Number).
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
_TermName |
Cadena |
Sí |
Identifica el término. El valor no distingue entre mayúsculas y minúsculas. Para ver una lista de los valores permitidos, consulte a continuación. |
N/A |
Dinero |
Dinero |
No |
Para obtener más detalles, consulte a continuación. |
N/A |
Texto |
Cadena |
No |
Para obtener más detalles, consulte a continuación. |
N/A |
Evento |
Fecha y hora |
No |
Para obtener más detalles, consulte a continuación. |
N/A |
Booleano |
Booleano |
No |
Para obtener más detalles, consulte a continuación. |
N/A |
Duración |
Cadena |
No |
Para obtener más detalles, consulte a continuación. |
N/A |
Number |
Entero |
No |
Para obtener más detalles, consulte a continuación. |
N/A |
El tipo de moneda
representa valores monetarios con especificación de moneda.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
valor |
Decimal |
No |
Valor monetario, obligatorio para algunos tipos de precios |
N/A |
_moneda |
Cadena |
Sí |
Código de moneda ISO |
N/A |
El tipo de duración Representa una duración de tiempo utilizando el formato de duración ISO 8601. Los valores deben especificarse en horas enteras.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
valor |
Cadena |
Sí |
Duración ISO 8601 en horas enteras. Formato: PT {N} H donde {N} es un número entero de horas. Por ejemplo, PT48H durante 48 horas o PT720H durante 30 días. |
N/A |
El tipo ContentSequenceInfo
especifica los números de secuencia de los episodios y las temporadas.
Atributo |
Type |
Necesario |
Notas |
Mapeo de archivos EMA |
Number |
Entero |
Sí |
Número de secuencia del contenido, como el número de episodio o el número de temporada |
N/A |
Términos de Avail admitidos (NOTA: desplázate hacia la derecha para ver el mapeo completo de
la EMA) En la siguiente tabla se enumeran todos los términos comerciales admitidos que se pueden incluir en la matriz AvailTerms. Cada término controla aspectos específicos de las licencias, los precios, la publicidad y la experiencia del cliente.
Nombre del término |
Atributo |
Necesario |
Notas |
Mapeo de archivos EMA |
Identidad del canal |
Texto |
Sí |
Identificador de un canal o suscripción. |
GroupIdentity |
Nivel |
Texto |
Condicional |
Nivel de precios. Obligatorio si el tipo de licencia es POEST. |
PriceType |
SRP |
Dinero |
Condicional |
Precio de venta sugerido. Obligatorio si el tipo de licencia es POEST. |
SRP |
WSP |
Dinero |
Condicional |
Precio mayorista. Obligatorio si el tipo de licencia es POEST. |
PriceValue |
Categoría |
Texto |
Condicional |
Categoría de precio. Obligatorio si el tipo de licencia es POEST. |
PriceValue |
AnnoceDate |
Evento |
No |
Fecha en la que el vendedor puede anunciar la fecha de inicio de la disponibilidad del título en el territorio disponible. |
AnnounceDate |
Fecha de suppressionliftDate |
Evento |
Condicional |
La primera fecha en que se anuncie públicamente que un título estará disponible en una fecha futura específica en el territorio en el que esté disponible. Obligatorio si el tipo de licencia es POEST. |
Fecha de suppressionliftDate |
Duración del alquiler |
Duración |
Condicional |
Duración del período de alquiler en horas. Obligatorio si el tipo de licencia es SVOD. |
Duración del alquiler |
WatchDuration |
Duración |
Condicional |
Cuánto tiempo tiene el usuario para completar la visualización una vez iniciada, en horas. Obligatorio si el tipo de licencia es SVOD. |
WatchDuration |
Download |
Texto |
No |
La licencia incluye permiso para descargar. Los valores válidos son Sí y No. Si el tipo de licencia es SVOD, se deben especificar tanto la duración del alquiler como la duración del reloj. |
Download |
Exclusivo |
Booleano |
No |
Los activos son exclusivos dentro del ámbito de la transacción. |
Exclusivo |
ExclusiveAttributes |
Texto |
No |
Especifica el tipo de exclusividad. Solo se considera cuando Exclusivo es verdadero. Se utilizará un valor predeterminado si no se proporciona cuando Exclusivo es verdadero. |
ExclusiveAttributes |
BrandingRights |
Booleano |
No |
Indica la intención del socio de mostrar su marca. |
BrandingRights |
Atributos de BrandingRight |
Texto |
No |
Especifica el texto de la marca. Solo se considera cuando BrandingRights es cierto. Se utilizará un valor predeterminado si no se proporciona cuando BrandingRights es verdadero. |
Atributos de BrandingRight |
Permitir anuncios |
Booleano |
No |
Determina si los anuncios están permitidos o prohibidos. Este término solo puede aparecer una vez. |
No disponible en EMA |
Reemplazo permitido |
Texto |
Condicional |
Especifica la ubicación del rollo en la que se pueden insertar los anuncios. Los valores permitidos son: PreRoll, MidRoll, PostRoll, Overlays, PauseAds y Squeezebacks. |
No disponible en EMA |
Reemplazo prohibido |
Texto |
Condicional |
Especifica la ubicación del rollo en la que no se pueden insertar anuncios. Los valores permitidos son: PreRoll, MidRoll, PostRoll, Overlays, PauseAds y Squeezebacks. |
No disponible en EMA |
Entrega y uso de CuePoint |
Texto |
No |
Especifica las obligaciones de entrega y uso del punto de referencia. Valores permitidos: Partner Will Deliver y Prime Video debe usar, Prime Video usará si se entrega, Sin obligaciones de entrega o uso, Talent Obligated. |
No disponible en EMA |
Blind Base se está vendiendo |
Texto |
No |
Valores permitidos: GuaranteedImpressions, NoGuaranteedImpressions |
No disponible en EMA |
patrocinios |
Texto |
No |
Valores permitidos: Permitido, Prohibido, Permitido con restricciones. |
No disponible en EMA |
Restricciones de patrocinio |
Texto |
Condicional |
Texto de formato libre |
No disponible en EMA |
| Directrices publicitarias de Talent y Amazon (** no deben tener saltos de línea) |
Texto |
No |
Valores permitidos: noRestrictions, consultationRequired |
No disponible en EMA |
Restricciones de talento |
Texto |
Condicional |
Texto de formato libre |
No disponible en EMA |
Límite de carga de anuncios |
Texto |
No |
Number of ad minutes per hour. Value debe ser un entero válido. |
No disponible en EMA |
AdKey |
Texto |
No |
Identificador |
No disponible en EMA |
Completa el (** no debe tener saltos de línea) |
Number |
No |
El descuento porcentual se aplica cuando los clientes completan un paquete comprando el resto de títulos que aún no poseen. Por ejemplo, un descuento del 20% significa que los clientes que posean la Temporada 1 de un paquete de 2 temporadas reciben un 20% de descuento en la Temporada 2. |
No disponible en EMA |
Excluido del (** no debe tener saltos de línea) |
Booleano |
No |
Si se establece en true, este período de disponibilidad se excluye de la elegibilidad para el descuento por paquete. Utilízalo durante los períodos de precios premium (p. ej., nuevos lanzamientos) o para títulos que deban mantener el precio completo. Si está ausente o es falso, el título es apto para descuentos en paquetes. |
No disponible en EMA |
Enumeración de BusinessLine
La enumeración de BusinessLine especifica el modelo de negocio de Prime Video según el cual se licencia y distribuye el contenido. Esto determina cómo los clientes acceden al contenido y cómo se generan los ingresos.
Value |
Description |
TVOD |
TVOD significa compra o alquiler. Tipos de licencias relacionadas: EST, VOD, POEST |
PRIME_SUBSCRIPTION |
Suscripción a Amazon Prime o Amazon Kids+. Tipos de licencia relacionados: SVOD |
CANALES |
Suscripción a canales de terceros. Tipos de licencia relacionados: SVOD |
VOD |
Contenido gratuito. Tipos de licencia relacionados: FVOD |
Nota: El valor de BusinessLine determina qué modelo de negocio se aplica a la disponibilidad de su contenido. Al enviar las ofertas, asegúrate de que BusinessLine cumpla con tu acuerdo contractual con Prime Video. Si tiene dudas sobre qué valores de BusinessLine están disponibles para su asociación, póngase en contacto con su representante de Prime Video.
Ejemplo de Payload Avils
Los siguientes ejemplos muestran cómo estructurar las llamadas a la API para escenarios de integración comunes. Consulta los ejemplos de carga útil para ver pares completos de solicitud/respuesta con el formato correcto de JSON que puedas usar como plantillas para tu integración.
