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
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.
https://partnerapi.primevideo.com/v1/assets/{licensor}/status/{ALID}?marketplace={marketplace}
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
https://partnerapi.primevideo.com/v1/assets/mgm/status/skuabc123?marketplace=global
https://partnerapi.primevideo.com/v1/assets/mgm/status/skuabc123
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. |
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. |
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 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.
{
"Destination": {
"Publisher": "TheDogChannel"
},
"Instructions": [],
"OverallProgressCode": "Ready",
"PlatformIDs": {
"GTI": "amzn1.dv.gti.e627fc28-5fde-435f-bc4e-44a9bad712df",
"PublisherIDs": [
{
"ALID": "FunWithTennisBalls",
"Marketplace": "GLOBAL"
}
]
},
"ProgressDetail": [
{
"ActionNeeded": 0,
"Progress": "Ready",
"Total": 11
}
],
"Scope": {
"ALID": "FunWithTennisBalls",
"BenefitID": "dogchannel",
"FormatProfile": null,
"LicenseType": null,
"Marketplace": "GLOBAL",
"Region": null
},
"Source": {
"Platform": "Prime Video"
},
"TitlePartStatus": [
{
"ActionType": "NO_ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["US"],
"RuleType": "NESTED",
"TitleParts": [
{
"FormatProfile": null,
"Locale": null,
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
}
]
}
],
"EarliestStartDate": "Wed Jun 01 04:00:00 UTC 2022",
"ExpectedDate": null,
"FirstDeliveryDate": null,
"FormatProfile": null,
"LastDelivery": {
"DeliveredDate": "Mon Feb 26 22:56:53 UTC 2024",
"DynamicRangeType": null,
"FileName": "passionflix_82_this-side-of-heaven_v5_MEC.xml",
"Hash": "3f73286984d4c71fd7a341c9b16be3ff",
"Instructions": null,
"Locale": "en-us",
"PresentationType": null,
"ServiceProvider": "stockholmstream",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": null,
"OfferContexts": [
{
"ALID": "FunWithTennisBalls",
"BenefitID": "dogchannel",
"FormatProfile": "HD",
"LicenseType": "SVOD",
"Marketplace": "GLOBAL",
"Region": "US"
}
],
"PrimaryType": "METADATA",
"PriorSuccessfulDelivery": {
"DeliveredDate": "Wed May 31 04:32:00 UTC 2023",
"DynamicRangeType": null,
"FileName": "fun_with_v4_MEC.xml",
"Hash": null,
"Instructions": null,
"Locale": "en-us",
"PresentationType": null,
"ServiceProvider": "thepound",
"Status": null
},
"Progress": "Ready",
"RuleSources": ["PUBLISHING_SPEC"],
"RuleType": "REQUIRED",
"SecondaryType": "NONE"
},
{
"ActionType": "NO_ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["US"],
"RuleType": "NESTED",
"TitleParts": [
{
"FormatProfile": "HD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
}
]
}
],
"EarliestStartDate": "Wed Jun 01 04:00:00 UTC 2022",
"FormatProfile": "HD",
"LastDelivery": {
"DeliveredDate": "Mon Feb 27 14:59:03 UTC 2023",
"DynamicRangeType": "SDR",
"FileName": "fun_with_tennis_mwf5.mp4",
"Hash": "88cbed6edabce11b9b503130081e7bd8",
"Instructions": null,
"Locale": "en-us",
"PresentationType": "MAIN",
"ServiceProvider": "thepound",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": null,
"OfferContexts": [
{
"ALID": "FunWithTennisBalls",
"BenefitID": "dogchannel",
"FormatProfile": "HD",
"LicenseType": "SVOD",
"Marketplace": "GLOBAL",
"Region": "US"
}
],
"PrimaryType": "VIDEO",
"Progress": "Ready",
"RuleType": "REQUIRED",
"SecondaryType": "MEZZ"
}
]
}
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.
{
"Destination": {
"Publisher": "1cendgametestpartner1"
},
"Instructions": [
{
"ErrorCode": null,
"Regions": null,
"TitlePart": {
"FormatProfile": "SD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
},
"TitlePartStatus": "NOT_DELIVERED"
},
{
"ErrorCode": null,
"Regions": null,
"TitlePart": {
"FormatProfile": "HD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
},
"TitlePartStatus": "NOT_DELIVERED"
},
{
"ErrorCode": "mec-validation-waiting-for-parent-sku-warning",
"Regions": [],
"TitlePart": {
"FormatProfile": null,
"Locale": "ja",
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
},
"TitlePartStatus": "SUCCESSFULLY_DELIVERED"
}
],
"OverallProgressCode": "Issue",
"ProgressDetail": [
{
"ActionNeeded": 0,
"Progress": "Ready",
"Total": 8
},
{
"ActionNeeded": 2,
"Progress": "Missing",
"Total": 2
}
],
"Scope": {
"ALID": "TLCPVAPITVSKU001EP4",
"BenefitID": null,
"FormatProfile": null,
"LicenseType": null,
"Marketplace": "GLOBAL",
"Region": null
},
"TitlePartStatus": [
{
"ActionType": "ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["DE", "PR", "AU", "JP", "GB", "US", "CA"],
"RuleType": "NESTED",
"TitleParts": [
{
"FormatProfile": "SD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
}
]
}
],
"EarliestStartDate": "Thu Jan 09 15:00:00 UTC 2025",
"FormatProfile": "SD",
"LastDelivery": null,
"Locale": null,
"OfferContexts": [
{
"ALID": "TLCPVAPITVSKU001EP4",
"BenefitID": "Prime",
"FormatProfile": "SD",
"LicenseType": "SVOD",
"Marketplace": "GLOBAL",
"Region": "US"
}
],
"PrimaryType": "VIDEO",
"PriorSuccessfulDelivery": null,
"Progress": "Missing",
"RuleSources": ["PUBLISHING_SPEC"],
"RuleType": "REQUIRED",
"SecondaryType": "MEZZ"
},
{
"ActionType": "NO_ACTION_NEEDED",
"LastDelivery": {
"DeliveredDate": "Tue Sep 24 01:04:20 UTC 2024",
"FileName": "1cendgametestpartner1-TLCPVAPITVSKU001EP4_MEC.xml",
"Instructions": [
{
"ErrorCode": "mec-validation-waiting-for-parent-sku-warning",
"Regions": [],
"TitlePart": null,
"TitlePartStatus": null
}
],
"Locale": "ja-jp",
"ServiceProvider": "1cendgametestpartner",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": "ja",
"PrimaryType": "METADATA",
"Progress": "Ready",
"RuleType": "RECOMMENDED",
"SecondaryType": "NONE"
},
{
"ActionType": "NO_ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["DE"],
"RuleType": "SINGLE",
"TitleParts": [
{
"FormatProfile": null,
"Locale": "de",
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
},
{
"FormatProfile": null,
"Locale": "en",
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
}
]
}
],
"LastDelivery": {
"DeliveredDate": "Tue Sep 24 01:04:20 UTC 2024",
"FileName": "1cendgametestpartner1-TLCPVAPITVSKU001EP4_MEC.xml",
"Instructions": [
{
"ErrorCode": "mec-validation-waiting-for-parent-sku-warning",
"Regions": [],
"TitlePart": null,
"TitlePartStatus": null
}
],
"Locale": "de-de",
"ServiceProvider": "1cendgametestpartner",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": "de",
"PrimaryType": "METADATA",
"Progress": "Ready",
"RuleType": "RECOMMENDED",
"SecondaryType": "NONE"
}
]
}
