Video Central

La API de Asset Status te permite comprobar qué envíos son necesarios para publicar tu título y el estado actual de cada envío (por ejemplo, exitoso, fallido o faltante) y, de no ser así, por qué. Centraliza los datos de entrega de activos en tus propios sistemas en lugar de consultar manualmente Slate, lo que te brinda visibilidad en tiempo real de todas tus entregas y tipos de activos. Puedes utilizar la API de Asset Status para visualizar cualquiera de los datos disponibles actualmente en la pestaña Assets de Slate.

¿Por qué usar la API de Offer Status?

Operaciones centralizadas: Extrae los datos de entrega de activos directamente en tus propios sistemas junto con tus otros canales de distribución; no hace falta iniciar sesión en Slate para cada verificación de estado
Resolución de problemas más rápida: Detecta problemas de entrega de inmediato y comprende qué está bloqueando la publicación de tus títulos, reduciendo así el tiempo de resolución
Gestión proactiva de activos: Monitorea todo tu catálogo mediante programación en todos los territorios y tipos de activos, lo que te permite escalar operaciones a medida que tu negocio crece.
Verificación de entrega en tiempo real: Sabrás al instante cuando tus activos se entreguen correctamente o si hay errores que requieran tu intervención

Esta API de solo lectura le permite enviar una solicitud con su identificador de título (ALID/SKU) y recibir información de estado en tiempo real para cada entrega de activos requerida. Si lo desea, puede filtrar su solicitud por mercado para adaptarla a requisitos de entrega específicos.

Qué recibirá: información sobre el estado de cada activo requerido, incluido el tipo de acción y la información de entrega detallada. Cada estado le indica dónde debe centrar su atención:

Acción necesaria: es necesaria una acción en ese activo concreto para que el título se publique. Esto podría significar que el activo se ha entregado pero se ha cometido un error o que no se ha entregado en absoluto.
Acción recomendada: no es necesaria ninguna acción para que el título se publique, pero recomendamos al socio que tome medidas para aumentar el rendimiento del título, por ejemplo, una ilustración localizada.
No es necesario realizar ninguna otra acción: no es necesario realizar ninguna otra acción.

Esquemas de solicitud y respuesta

Esta sección proporciona especificaciones técnicas para que los desarrolladores integren la API de Asset Status en sus sistemas. Usa esta referencia para entender el formato de la solicitud, la estructura de las respuestas y los tipos de datos que devuelve la API.

Formato de solicitud

La API de Asset Status utiliza una estructura de recuperación simple mediante solicitudes GET, donde todos los parámetros de consulta se pasan a través de la URL; no se requiere un cuerpo de solicitud. Esto facilita la integración en tus sistemas y permite realizar pruebas utilizando clientes HTTP estándar o herramientas de línea de comandos. Simplemente construye la URL con el identificador de tu título y los filtros opcionales; luego, envía una solicitud GET para recuperar el estado actual de las entregas de tus activos.

Parameters
Esta tabla define los parámetros que puedes usar para consultar la información del estado de los activos.

Parámetro	Tipo	Es obligatorio	Descripción
licensor	String	Sí	El identificador de tu organización proporcionado por Prime Video durante el proceso de incorporación.
ALID	String	Sí	Identificador de título (ALID o SKU) que coincida con tu contribución.
marketplace	String	No	El Marketplace de Amazon al que enviaste el título. El valor predeterminado es GLOBAL y no es necesario proporcionarlo. Si estás buscando un título en tu catálogo de Classic Marketplace, indícalo como parámetro. Valores permitidos: GLOBAL, US, DE, JP, GB

Ejemplos de solicitudes

Nota: Cuanto más específicos sean los parámetros de tu solicitud, más específica será tu respuesta. Si omites parámetros opcionales como marketplace, la API devolverá información de estado para todos los alcances aplicables asociados con ese ALID.

Esquema de respuesta

El esquema de respuesta define la estructura de los datos devueltos por la API de Asset Status. La comprensión de estos tipos de datos le ayudará a analizar la respuesta e integrar la información de estado en sus sistemas de manera eficaz.

ProductStatus
La respuesta de nivel superior que contiene información sobre el estado del activo para el título solicitado. Cada respuesta incluye datos de estado filtrados por los parámetros de tu solicitud, lo que te permite conocer el estado de entrega en diferentes tipos de activos y requisitos.

Nombre de campo	Tipo	Es obligatorio	Descripción
Source	DeliveryPlatform	Sí	Plataforma de entrega de origen. Ten en cuenta que siempre debe ser Prime Video.
Destination	DeliveryPublisher	Sí	El alias del socio del título que recibe los activos.
Scope	DeliveryScope	Sí	Información sobre el alcance de entrega
PlatformIDs	PlatformIdentifiers	Sí	Identificadores de plataforma
OverallProgressCode	ProgressCode	Sí	Código de progreso general: Ready, Issue, In-Process, Missing
ProgressDetail	ProgressDetailItem[]	Sí	Lista de detalles del progreso
TitlePartStatus	ProductTitlePartStatus[]	Sí	Información sobre el estado de las partes del título
Instructions	ProductDeliveryInstruction[]	No	Instrucciones de entrega

Tipo DeliveryPlatform
Información de la plataforma de entrega de origen.

Nombre de campo	Tipo	Es obligatorio	Descripción
Platform	String	Sí	Plataforma de entrega de origen. Ten en cuenta que siempre debe ser Prime Video.

Tipo DeliveryPublisher
Información del editor de destino. Esto identifica a tu organización como la destinataria del contenido.

Nombre de campo	Tipo	Es obligatorio	Descripción
Publisher	String	Sí	El alias del socio del título que recibe los activos.

Tipo de DeliveryScope
Información sobre el alcance de entrega que define el contexto de la consulta del estado del activo.

Nombre de campo	Tipo	Es obligatorio	Descripción
ALID	String	Sí	Identificador lógico o SKU del activo
Marketplace	String	Sí	El Marketplace de Amazon al que enviaste el título. El valor predeterminado es GLOBAL y no es necesario proporcionarlo. Valores permitidos: GLOBAL, US, DE, JP, GB
Region	String	No	Región o territorio
FormatProfile	String	No	Calidad del vídeo disponible. Valores permitidos: SD, HD, UHD, MAX
LicenseType	String	No	Valores permitidos: SVOD, FVOD, EST, POEST, VOD
BenefitID	String	No	Identificador de un canal o suscripción (requerido para ofertas de SVOD).

Tipo de PlatformIdentifiers
Estructura de identificadores de plataforma que contiene identificadores de título.

Nombre de campo	Tipo	Obligatorio	Descripción
GTI	String	Sí	Identificador global de título
PublisherIDs	PublisherIdentifier[]	Sí	Identificadores de publicadores

Tipo de PublisherIdentifier
La lista de identificadores proporcionados por el socio.

Nombre de campo	Tipo	Obligatorio	Descripción
ALID	String	Sí	Identificador de título
Marketplace	String	Sí	El Marketplace de Amazon al que enviaste el título. El valor predeterminado es GLOBAL y no es necesario proporcionarlo. Valores permitidos: GLOBAL, US, DE, JP, GB

Tipo de ProgressCode
Valores de enumeración del código de progreso que indican el estado general de la entrega de activos.

Valor	Descripción
Ready	Los activos se han ingerido
Issue	Hay un problema con la entrega o el procesamiento de los activos
In-Process	Los activos se están entregando y procesando
Missing	Aún no se ha entregado un activo específico

Tipo de ProgressDetailItem
Estructura de elementos de detalle del progreso que proporciona estadísticas resumidas.

Nombre de campo	Tipo	Obligatorio	Descripción
Progress	ProgressCode	Sí	Código de progreso
Total	Long	Sí	Recuento total de activos
ActionNeeded	Long	Sí	Número de activos del recuento total que requieren acción

Tipo de ProductTitlePartStatus
La estructura de datos central que representa el estado de una única entrega de activos requerida. Esto incluye el estado de entrega, los requisitos de acción y los datos detallados a nivel de transacción.

Nombre de campo	Tipo	Es obligatorio	Descripción
PrimaryType	String	Sí	El tipo principal del activo
SecondaryType	String	Sí	Tipo secundario: por ejemplo, si el tipo principal era IMAGE, el subtipo podría ser 2x3 o Poster
FormatProfile	String	No	Perfil de formato o calidad
Locale	String	No	Configuración regional: p. ej. en-US o es-419
OfferContexts	DeliveryScope[]	Sí	Cada OfferContext representa una configuración de oferta específica (región, tipo de licencia, perfil de formato, etc.) que utiliza el activo
ConditionalTitleParts	ProductConditionalTitlePart[]	No	Partes de título condicionales
RuleType	String	Sí	Tipo de regla: required, recommended, conditional
ActionType	String	Sí	Tipo de acción
RuleSources	String[]	Sí	Fuentes de reglas
LastDelivery	ProductDelivery	No	Información sobre la última entrega
PriorSuccessfulDelivery	ProductDelivery	No	Información de entrega exitosa previa
FirstDeliveryDate	String	No	Fecha de la primera entrega
Progress	ProgressCode	Sí	Código de progreso: Ready, Issue, In-Process, Missing
ExpectedDate	String	No	Fechas de entrega esperadas
EarliestStartDate	String	No	Fecha de inicio más próxima

Valores de PrimaryType comunes
El campo PrimaryType identifica la categoría del activo que se entrega.

Valor	Descripción
METADATA	Metadatos del título (descripciones, reparto, equipo, etc.)
VIDEO	Archivos de video mezzanine
IMAGE	Material gráfico (arte de caja, arte de portada, imágenes principales, pósteres)
AUDIO	Pistas de audio
TIMED_TEXT	Subtítulos y subtítulos para sordos

Valores comunes de ActionType
El campo ActionType indica si es necesario tomar medidas en relación con una entrega de activos específica.

Valor	Descripción
ACTION_NEEDED	Falta el recurso o tiene errores que deben resolverse para que el título se publique
ACTION_RECOMMENDED	El activo no es obligatorio, pero se recomienda para una mejor experiencia del cliente
NO_ACTION_NEEDED	El activo se ha entregado correctamente, no es necesario realizar ninguna acción

Valores comunes de RuleType
El campo RuleType define si un activo es obligatorio u opcional para que se publique tu título.

Valor	Descripción
required	Debe entregarse para que el título se publique
recommended	No es obligatorio, pero mejora la experiencia del cliente
conditional	Obligatorio solo si se cumplen ciertas condiciones

Tipo de ProductConditionalTitlePart
Estructura condicional de la parte del título que define los requisitos condicionales para la entrega de activos.

Nombre de campo	Tipo	Es obligatorio	Descripción
RuleType	String	Sí	Tipo de regla
Regions	String[]	Sí	Lista de regiones o territorios
TitleParts	ProductTitlePartDescriptor[]	Sí	Partes del título

Valores de RuleType
El campo RuleType define la relación lógica entre las partes de título condicionales.

Valor	Descripción
NESTED	Todas las partes del título en la estructura deben cumplirse (lógica AND)
SINGLE	Cualquiera de las partes del título cumple con el requisito (lógica OR)

Tipo de ProductTitlePartDescriptor
Estructura descriptiva de la parte del título que define un requisito específico de la parte del título.

Nombre de campo	Tipo	Es obligatorio	Descripción
PrimaryType	String	Sí	El tipo principal del activo
SecondaryType	String	Sí	Tipo secundario: por ejemplo, si el tipo principal era IMAGE, el subtipo podría ser 2x3 o Poster
FormatProfile	String	No	Perfil de formato o calidad
Locale	String	No	Configuración regional: p. ej. en-US o es-419

Tipo de ProductDelivery
Información de entrega de productos que proporciona información detallada sobre la entrega de un activo. Este campo será nulo si el activo aún no se ha entregado.

Nombre de campo	Tipo	Es obligatorio	Descripción
Status	String	No	Estado de entrega: NOT_DELIVERED o SUCCESSFULLY_DELIVERED
FileName	String	No	Nombre de archivo
Hash	String	No	Hash de archivo o suma de comprobación
DeliveredDate	String	No	Fecha de entrega en formato ISO 8601
Locale	String	No	Locale
ServiceProvider	String	No	Proveedor de servicios o cuenta de entrega
PresentationType	String	No	Tipo de presentación
DynamicRangeType	String	No	Tipo de rango dinámico
Instructions	ProductDeliveryInstruction[]	No	Instrucciones de entrega o errores

Valores de Status comunes
El campo Status indica si la entrega de un activo se recibió y procesó correctamente.

Valor	Descripción
SUCCESSFULLY_DELIVERED	El activo se entregó y procesó correctamente
NOT_DELIVERED	No se ha recibido el activo

Tipo de ProductDeliveryInstruction
Estructura de instrucciones de entrega del producto que proporciona códigos de error e información de estado. Las instrucciones pueden aparecer en la respuesta de nivel superior (resumiendo todos los problemas de entrega) o en los objetos ProductDelivery (específicos de las entregas de activos individuales).

Nombre de campo	Tipo	Es obligatorio	Descripción
TitlePart	ProductTitlePartDescriptor	No	Descriptor de la parte del título
TitlePartStatus	String	No	Estado de entrega de la parte del título
ErrorCode	String	No	Código de error
Regions	String[]	No	Lista de regiones o territorios

Valores comunes de TitlePartStatus
El campo TitlePartStatus indica el estado de entrega de un activo en los mensajes de instrucciones.

Valor	Descripción
NOT_DELIVERED	El activo no se ha entregado
SUCCESSFULLY_DELIVERED	El activo se entregó correctamente

Nota: Los esquemas anteriores representan la estructura de respuesta de la API actual y es posible que se mejoren en futuras versiones.

Ejemplo de respuesta

Los siguientes ejemplos muestran las respuestas típicas de la API para diferentes escenarios. Utilízalos para entender la estructura de las respuestas y cómo interpretar la información de estado.

Ejemplo 1: Todos los activos se entregaron correctamente

En este ejemplo se muestra una respuesta de la API típica para un título de película en el que todos los recursos necesarios se han entregado correctamente. La respuesta muestra el estado Ready sin necesidad de realizar ninguna acción.

Ejemplo 2: Faltan activos requeridos

En este ejemplo, se muestra una respuesta de la API cuando faltan los activos requeridos y se muestra cómo la API indica el estado ACTION_NEEDED y proporciona información sobre los errores.

Caso de uso: has enviado los metadatos de un episodio de TV, pero aún no has entregado los archivos de vídeo. La API muestra qué formatos de vídeo faltan y cuáles bloquean la publicación.

Diferencias clave con respecto al ejemplo 1:

En general, ProgressCode es «Problema» en lugar de «Listo»
ProgressDetail muestra el recuento de ActionNeeded de 2
Las entradas de TitlePartStatus con el tipo de acción «ACTION_NEEDED» tienen un valor LastDelivery nulo
La matriz de instrucciones del nivel superior muestra el estado NOT_DELIVERED
Algunos activos entregados incluyen advertencias de validación en sus instrucciones

Preguntas frecuentes

En las siguientes secciones se proporcionan respuestas a preguntas frecuentes sobre cómo trabajar con la API de Asset Status.

La matriz de instrucciones proporciona códigos de error detallados e información de estado:

Instrucciones de nivel superior: resumen de todos los problemas de entrega en todos los activos
Instrucciones de entrega del producto: advertencias o errores específicos para las entregas de activos individuales
Código de error: identifica el problema específico (por ejemplo, advertencias de validación o dependencias faltantes)
titlePartStatus: muestra si el activo se entregó (SUCCESSFULLY_DELIVERY, NOT_DELIVERY)