API de Importación de programación

Responde con una hoja con las columnas que lee una importación de programación y tres filas de ejemplo (un código de pantalla, una carpeta de pantallas y una etiqueta), como CSV o, con format=xlsx, un libro XLSX.

Lee una hoja de filas de programación contra el proyecto y responde qué haría confirmarla, sin escribir nada.

Cada fila indica un destino (una pantalla por id, por el valor de un campo de pantalla como un código de sala, o por nombre; folder:NAME; tag:NAME; varios separados por ; o |), el contenido (un nombre de archivo multimedia, o playlist:NAME o un id de lista de reproducción), un inicio y un fin (una fecha sola como fin cierra ese día) y, opcionalmente, timezone, days (Mon-Fri), una ventana diaria (daily_start, daily_end), priority de 0 a 100, un nombre y números de pantalla.

Las horas se leen en el reloj propio de cada pantalla; una columna timezone las convierte desde otra zona.

Cada fila se verifica e informa sus errores por columna: pantalla, carpeta o etiqueta desconocida o ambigua, archivo faltante o ambiguo, un archivo que no puede llenar una pantalla, horas inválidas o invertidas, un fin en el pasado, ninguna indicación de tiempo, una pantalla sin zona horaria o sin lista de reproducción predeterminada, dos filas vigentes a la vez en una pantalla con la misma prioridad, y más niveles de los que admite una pantalla (32), o más campañas de las que admite su organización en todos sus proyectos (100; cada nivel compartido cuenta como una).

Las filas que coinciden en contenido, horas, prioridad y nombre forman un nivel: una pantalla es una entrada de la programación propia de esa pantalla; varias pantallas, una carpeta o una etiqueta son un nivel compartido (una campaña), que prevalece sobre los niveles propios de una pantalla.

La respuesta lista los niveles con lo que hace una confirmación a cada uno (create, update, unchanged), los niveles que una ejecución anterior de la misma importación creó y que la hoja ya no tiene (removals), las pilas de las pantallas tal como quedarían (calendar) y una huella para enviar a la confirmación. La hoja son filas JSON, CSV o XLSX, de como máximo 5,000 filas.

No disponible para un llamador limitado a pantallas (outside_screen_scope). La importación de programación forma parte del plan Enterprise; un proyecto cuyo plan no lo incluye se rechaza con feature_not_in_plan (402). La plantilla está abierta en todos los planes.

Confirma una importación con vista previa: la misma hoja y la huella que respondió su vista previa. Cada nivel se crea, se actualiza o se elimina, las programaciones de las pantallas y los niveles compartidos se escriben en una sola transacción, y se añade el evento de importación schedule.imported: todas las filas se aplican o ninguna.

Primero se crean las listas de reproducción de un solo archivo que necesitan los archivos de la hoja (no cambian nada en ninguna pantalla). Una hoja cuyas filas tienen errores se rechaza (schedule_import_invalid); un proyecto que cambió desde la vista previa, o filas que se leen de otra forma, se rechaza (schedule_import_stale), y el cliente previsualiza de nuevo.

Importar la misma hoja de nuevo con el mismo nombre no cambia nada; una fila modificada actualiza su nivel y una fila eliminada elimina su nivel. Requiere una persona que pueda aprobar en el dashboard y, para un agente, una credencial con acceso de escritura.

Una confirmación que actualizaría o eliminaría una campaña reservada responde reserved_item (403) y no escribe nada, a menos que la confirme una persona que puede aprobar.

Una confirmación que alcanza una pantalla protegida se rechaza por completo con protected_target, también cuando la importación no tiene niveles pero elimina entradas de importación de una pantalla protegida o elimina una campaña de importación cuya audiencia alcanza una.

En un proyecto con carpetas de pantallas protegidas, una confirmación cuya vista previa falla en un servicio, no en la hoja, responde dependency_unavailable y no escribe nada: envíe la misma solicitud de nuevo tras una breve espera. Un error de validación de hoja, campaña o pantalla responde como lo haría la confirmación (invalid_request y los demás problemas de arriba).

No disponible para un llamador limitado a pantallas. La importación de programación forma parte del plan Enterprise; un proyecto cuyo plan no lo incluye se rechaza con feature_not_in_plan (402). La plantilla está abierta en todos los planes.