API Importation d’horaires

Répond avec une feuille contenant les colonnes que lit une importation d’horaires et trois lignes d’exemple (un code d’écran, un dossier d’écrans et une étiquette), en CSV ou, avec format=xlsx, en classeur XLSX.

Lit une feuille de lignes d’horaire par rapport au projet et répond à ce que ferait sa validation, sans rien écrire.

Chaque ligne nomme une cible (un écran par identifiant, par la valeur d’un champ d’écran comme un code de salle, ou par nom ; folder:NAME ; tag:NAME ; plusieurs séparées par ; ou |), un contenu (un nom de fichier multimédia, ou playlist:NAME ou un identifiant de liste de lecture), un début et une fin (une date seule comme fin ferme ce jour), et facultativement timezone, days (Mon-Fri), une plage quotidienne (daily_start, daily_end), priority de 0 à 100, un nom et des numéros d’affichage.

Les heures sont lues sur l’horloge propre à chaque écran ; une colonne timezone les convertit depuis un autre fuseau.

Chaque ligne est vérifiée et signale ses erreurs par colonne : écran, dossier ou étiquette inconnu ou ambigu, fichier manquant ou ambigu, fichier qui ne peut pas remplir un écran, heures invalides ou inversées, fin dans le passé, aucune indication de temps, écran sans fuseau horaire ni liste de lecture par défaut, deux lignes en vigueur en même temps sur un écran à la même priorité, et plus de niveaux que n’en contient un écran (32), ou plus de campagnes que n’en contient son organisation, tous projets confondus (100 ; chaque niveau partagé en compte une).

Les lignes qui s’accordent sur le contenu, les heures, la priorité et le nom forment un seul niveau : un écran donne une entrée de l’horaire propre à cet écran ; plusieurs écrans, un dossier ou une étiquette donnent un niveau partagé (une campagne), qui l’emporte sur les niveaux propres d’un écran.

La réponse liste les niveaux avec ce que fait une validation à chacun (create, update, unchanged), les niveaux qu’une exécution antérieure de la même importation a créés et que la feuille n’a plus (removals), les piles des écrans telles qu’elles seraient (calendar), et une empreinte à envoyer à la validation. La feuille est des lignes JSON, un CSV ou un XLSX, de 5 000 lignes au plus.

Non disponible pour un appelant limité aux écrans (outside_screen_scope). L’importation d’horaires fait partie du forfait Enterprise ; un projet dont le forfait n’inclut pas cette fonctionnalité est refusé avec feature_not_in_plan (402). Le modèle est ouvert à tous les forfaits.

Valide une importation prévisualisée : la même feuille et l’empreinte que son aperçu a renvoyée. Chaque niveau est créé, mis à jour ou supprimé, les horaires des écrans et les niveaux partagés sont écrits en une seule transaction, et l’événement d’importation schedule.imported est ajouté : toutes les lignes s’appliquent ou aucune.

Les listes de lecture à fichier unique dont les fichiers de la feuille ont besoin sont créées en premier (elles ne changent rien sur aucun écran). Une feuille dont les lignes ont des erreurs est refusée (schedule_import_invalid) ; un projet qui a changé depuis l’aperçu, ou des lignes qui se lisent autrement, est refusé (schedule_import_stale), et le client refait un aperçu.

Importer de nouveau la même feuille sous le même nom ne change rien ; une ligne modifiée met à jour son niveau et une ligne retirée supprime son niveau. Demande une personne qui peut approuver dans le tableau de bord et, pour un agent, des identifiants avec accès en écriture.

Une validation qui mettrait à jour ou supprimerait une campagne réservée répond reserved_item (403) et n’écrit rien, sauf si elle est validée par une personne qui peut approuver.

Une validation qui atteint un écran protégé est refusée en entier avec protected_target, même quand l’importation n’a aucun niveau mais retire les entrées d’importation d’un écran protégé ou supprime une campagne d’importation dont l’audience en atteint un.

Dans un projet avec des dossiers d’écrans protégés, une validation dont l’aperçu échoue à cause d’un service, et non de la feuille, répond dependency_unavailable et n’écrit rien : renvoyez la même requête après une courte attente. Une erreur de validation de feuille, de campagne ou d’écran répond comme la validation le ferait (invalid_request et les autres problèmes ci-dessus).

Non disponible pour un appelant limité aux écrans. L’importation d’horaires fait partie du forfait Enterprise ; un projet dont le forfait n’inclut pas cette fonctionnalité est refusé avec feature_not_in_plan (402). Le modèle est ouvert à tous les forfaits.