Video Central

En esta sección se proporcionan ejemplos de solicitudes y respuestas para operaciones comunes de la API de Avails. Cada ejemplo muestra la estructura JSON correcta y los campos obligatorios, lo que te ayuda a crear y probar tu integración con Prime Video. Usa estos ejemplos como plantillas cuando envíes y actualices tus existencias. Puedes copiarlos directamente en tu consola para verificar tu implementación antes de enviar contenido a Prime Video.

Una carga útil son los datos que envías o recibes de la API, es decir, el contenido real de tu solicitud o respuesta. Considérala el paquete de información que intercambias con los sistemas de Prime Video. Cada ejemplo muestra la estructura JSON correcta y los campos obligatorios para situaciones comunes, lo que te ayuda a formatear tus solicitudes de API e interpretar las respuestas de Prime Video.

Crear/actualizar muestras de carga útil de la API Avils

La API Avils te permite crear y actualizar las ventanas de disponibilidad de tu contenido en el sistema de Prime Video. En esta sección se proporcionan ejemplos de solicitudes y respuestas, y se muestra cómo estructurar las llamadas a la API en distintos escenarios.

Ejemplo 1: Episodio de Canal con múltiples Avils

Caso de uso: estás licenciando un episodio a varios canales de suscripción con diferentes ofertas de formatos. En este ejemplo, se muestra cómo indicar la disponibilidad del mismo episodio en dos canales: uno con ventanas UHD y HD y otro con ventana SD.
Por qué usar Full Extract: Full Extract reemplaza todos los datos de disponibilidad para una combinación específica de título/territorio/línea de negocio, lo que lo convierte en la opción ideal cuando quieres asegurarte de que Prime Video tiene tu panorama completo de disponibilidad actual.
Funcionamiento: PutAvailsFullExtract

Solicitud 1: Disponibilidad a nivel de episodio con 2 ventanas: esta solicitud crea la disponibilidad de un episodio en un canal de suscripción con dos niveles de formato de vídeo UHD y HD:

Solicitud 2: Disponibilidad a nivel de temporada para una ventana de vídeo
única Esta solicitud crea disponibilidad para toda la Temporada 1 en un canal de suscripción diferente en formato SD:

Ejemplo 2: Película VOD con múltiples localizaciones

Ejemplo 3: Película TVOD

Ejemplo 4: Tráiler de la película

Caso de uso: estás indicando la disponibilidad de un tráiler de película para que esté disponible de forma gratuita en varios formatos. Los tráileres se clasifican como contenido «complementario» y son un tipo de material de valor añadido (VAM), contenido promocional o adicional que mejora la experiencia del cliente más allá del título principal.
Por qué usar Full Extract: Full Extract garantiza que todos los períodos de disponibilidad del tráiler estén actualizados. Dado que los tráileres son contenido promocional, suelen estar disponibles en todo el mundo sin fecha de finalización para que puedan ser descubiertos de forma continua.
Funcionamiento: PutAvailsFullExtract

Ejemplo 5: Tráiler de una Serie de TV

Caso de uso: estás enviando la disponibilidad del tráiler de una temporada de una serie de TV para promocionar una próxima temporada. Al igual que los tráilers de películas, los tráilers de TV son contenido «suplementario» y son un tipo de Value Added Material (VAM) que mejora la participación de los clientes con la serie.
Por qué usar Full Extract: Full Extract garantiza que la disponibilidad del tráiler esté completa y actualizada. Los tráileres de TV a menudo necesitan actualizaciones a medida que se anuncian nuevas temporadas o cambian las fechas de lanzamiento.
Operación: PutAvailsFullExtract

Ejemplo 6: paquete de películas con descuento

Caso de uso: estás indicando la disponibilidad de un paquete de colección de películas que agrupa varios títulos relacionados a un precio reducido. Los paquetes permiten a los clientes comprar varias películas en un solo paquete, con el descuento «Completa tu paquete» si ya tienen algunos títulos de la colección.
¿Qué son los paquetes? Los paquetes (también llamados colecciones o conjuntos de cajas) agrupan el contenido relacionado para su compra en un paquete. Los paquetes de películas suelen incluir películas de la misma franquicia, director, género o tema. Para obtener información detallada sobre los tipos de paquetes, las especificaciones y los requisitos de entrega, consulta: Documentación general del paquete.
Por qué usar Full Extract: Full Extract garantiza que todos los datos de disponibilidad de los paquetes estén actualizados, incluidos los precios, los títulos de los paquetes y las condiciones de descuento. Esto es esencial cuando la composición o los precios de los paquetes cambian.
Operación: PutAvailsFullExtract

Ejemplo 7: Paquete de Series de TV

Caso de uso: estás indicando la disponibilidad de un paquete completo de series de TV (caja) que incluye todas las temporadas. Esto permite a los clientes que ya tienen temporadas individuales comprar las temporadas restantes con un descuento.
¿Qué son los paquetes de TV? Los paquetes de TV (cajas) agrupan todas las temporadas de una serie para comprarlos como un paquete. Para obtener información detallada, consulta la documentación general del paquete.
Operación: PutAvailsFullExtract

Ejemplo 8: Descuento de películas excluidas de paquetes

Caso práctico: estás indicando la disponibilidad de una película con varios niveles de precios a lo largo del tiempo, por lo que el período inicial de precios premium debe excluirse de los descuentos por paquetes. Esto impide que los clientes obtengan descuentos en el acceso durante el período premium.
¿Qué está excluido de BundleDiscount? Este término impide que un título pueda optar a los descuentos de Complete Your Bundle durante períodos de disponibilidad específicos. Esto es útil para períodos de precios específicos en los que deseas mantener el precio completo.
Operación: PutAvailsFullExtract

Recupere muestras de la API de Avils

En esta sección se proporcionan ejemplos de solicitudes y respuestas, que muestran cómo estructurar las llamadas a la API para acceder a la información de derechos de contenido existente.

Ejemplo 1: Recuperar la Disponibilidad del Título

Caso de uso: desea recuperar todos los períodos de disponibilidad actuales de un título específico en un territorio y una línea de negocio. Esto resulta útil para comprobar lo que Prime Video tiene archivado, solucionar discrepancias o extraer datos para generar informes y conciliarlos.
Por qué usar Full Extract: Full Extract recupera todos los datos de disponibilidad de una combinación específica de ALID, territorio y línea de negocio, lo que le brinda una imagen completa de cómo está configurado actualmente el contenido en los sistemas de Prime Video.
Funcionamiento: getAvailsFullExtract

Ejemplos de API Validate Avils

La API Avils te permite comprobar si hay errores en tus ventanas de disponibilidad antes de enviarlas a los sistemas en directo de Prime Video. En esta sección se proporcionan ejemplos de solicitudes y respuestas, y se muestra cómo estructurar las llamadas a la API para detectar los errores en una fase temprana del flujo de trabajo de integración.

Ejemplo 1: Validar la Disponibilidad Completa de los Datos

Caso práctico: quieres validar todos los datos de disponibilidad de un título antes de enviarlo a los sistemas en directo de Prime Video. Esto garantiza que la carga útil tenga el formato correcto y cumpla con todas las normas empresariales.
Por qué utilizar la validación Full Extract: la validación Full Extract comprueba todos los períodos de disponibilidad para detectar una combinación de título, territorio y línea de negocio, lo que garantiza que el envío completo esté libre de errores antes de publicarlo.
Operación: ValidateAvailsFullExtract

Eliminar muestras de API de Avils

Nota: Recomendamos encarecidamente que el contenido caduque ajustando la fecha de finalización en lugar de eliminarlo, excepto en casos de uso puntuales. Al expirar se mantienen los datos históricos y el registro de auditoría.

Ejemplo 1: Eliminar Toda la Disponibilidad de un título

Caso de uso: debes eliminar por completo todas las ventanas de disponibilidad de un título específico en un territorio y una línea de negocio. Se trata de una operación poco frecuente que se suele utilizar cuando el contenido se ha enviado por error o cuando las obligaciones contractuales exigen su eliminación total y no su caducidad.
Por qué usar Full Extract: Full Extract delete elimina todos los datos de disponibilidad de una combinación específica de ALID, territorio, línea de negocio y contrato. Se trata de una operación amplia que borra todas las ventanas que coincidan con estos parámetros.
Operación: DeleteAvailsFullExtract

Referencias útiles

Puedes incorporarte fácilmente a nuestras API de Prime Video. Encontrarás información detallada sobre cómo incorporarte a cada paquete de API en la guía de incorporación. Tenga en cuenta que el proceso de incorporación del paquete de API de contenido y del paquete de API de análisis es independiente.

El Content API Suite te permite automatizar los flujos de trabajo de administración de contenido y recibir visibilidad en tiempo real del estado de tu contenido en Prime Video. Esta suite incluye:

API Avails: Enviar, actualizar, recuperar y eliminar los derechos de contenido (disponibles) mediante programación en todas las líneas de negocio y territorios
API de estado de la oferta: comprueba si tus títulos están disponibles en la tienda Prime Video y descubre qué es lo que impide que se publiquen
API de estado de activos: supervise el estado de entrega de los activos y reciba comentarios instantáneos sobre la preparación del contenido

Cuando se incorpore a Content API Suite, recibirá acceso a las API que solicite durante el proceso de incorporación. Todas las API de este paquete utilizan la autenticación basada en certificados MTLS (Mutual Transport Layer Security) con claves de API.

Avails: muestras de carga útil de la API