API Importazione programmazione

Risponde con un foglio con le colonne lette da un’importazione di programmazione e tre righe di esempio (un codice schermo, una cartella di schermi e un tag), come CSV oppure, con format=xlsx, come cartella di lavoro XLSX.

Legge un foglio di righe di programmazione rispetto al progetto e risponde con ciò che farebbe il commit, senza scrivere nulla.

Ogni riga indica una destinazione (uno schermo per id, per valore di un campo dello schermo come un codice stanza, o per nome; folder:NAME; tag:NAME; più destinazioni separate da ; o |), un contenuto (il nome di un file multimediale, oppure playlist:NAME o un id di playlist), un inizio e una fine (una sola data come fine chiude quel giorno) e, facoltativamente, timezone, days (Mon-Fri), una finestra giornaliera (daily_start, daily_end), priority da 0 a 100, un nome e i numeri dei display.

Gli orari sono letti sull’orologio di ciascuno schermo; una colonna timezone li converte da un altro fuso.

Ogni riga viene controllata e segnala i suoi errori per colonna: schermo, cartella o tag sconosciuto o ambiguo, file mancante o ambiguo, un file che non può riempire uno schermo, orari non validi o invertiti, una fine nel passato, nessuna indicazione di tempo, uno schermo senza fuso orario o playlist predefinita, due righe valide insieme su uno schermo con la stessa priorità, e più livelli di quelli che uno schermo può contenere (32), o più campagne di quelle che la sua organizzazione può avere in tutti i suoi progetti (100; ogni livello condiviso ne è una).

Le righe che coincidono per contenuto, orari, priorità e nome diventano un solo livello: uno schermo è una voce della sua programmazione propria; più schermi, una cartella o un tag sono un unico livello condiviso (una campagna), che prevale sui livelli propri di uno schermo.

La risposta elenca i livelli con ciò che un commit fa a ciascuno (create, update, unchanged), i livelli creati da un’esecuzione precedente della stessa importazione che il foglio non ha più (removals), gli stack degli schermi come sarebbero (calendar) e un fingerprint da inviare al commit. Il foglio è composto da righe JSON, CSV o XLSX, al massimo 5.000 righe.

Non disponibile per un chiamante limitato agli schermi (outside_screen_scope). L’importazione programmazione fa parte del piano Enterprise; un progetto il cui piano ne è privo viene rifiutato con feature_not_in_plan (402). Il modello è disponibile in ogni piano.

Esegue il commit di un’importazione in anteprima: lo stesso foglio e il fingerprint restituito dalla sua anteprima. Ogni livello viene creato, aggiornato o rimosso, le programmazioni degli schermi e i livelli condivisi vengono scritti in un’unica transazione e l’evento di importazione schedule.imported viene aggiunto: tutte le righe vengono applicate, oppure nessuna.

Le playlist di un solo file necessarie ai file del foglio vengono create per prime (non cambiano nulla su alcuno schermo). Un foglio con righe con errori viene rifiutato (schedule_import_invalid); un progetto cambiato dopo l’anteprima, o righe lette in modo diverso, viene rifiutato (schedule_import_stale) e il client visualizza di nuovo l’anteprima.

Importare di nuovo lo stesso foglio con lo stesso nome non cambia nulla; una riga modificata aggiorna il suo livello e una riga rimossa rimuove il suo livello. Serve una persona che possa approvare nella dashboard e, per un agente, una credenziale con accesso in scrittura.

Un commit che aggiornerebbe o eliminerebbe una campagna riservata risponde con reserved_item (403) e non scrive nulla, a meno che non lo esegua una persona che può approvare.

Un commit che raggiunge uno schermo protetto viene rifiutato per intero con protected_target, anche quando l’importazione non ha livelli ma rimuove voci importate di uno schermo protetto o elimina una campagna importata il cui pubblico ne raggiunge uno.

In un progetto con cartelle di schermi protette un commit la cui anteprima fallisce a causa di un servizio, non del foglio, risponde con dependency_unavailable e non scrive nulla: invia di nuovo la stessa richiesta dopo una breve attesa. Un errore di convalida del foglio, della campagna o dello schermo risponde come risponderebbe il commit (invalid_request e gli altri problemi sopra).

Non disponibile per un chiamante limitato agli schermi. L’importazione programmazione fa parte del piano Enterprise; un progetto il cui piano ne è privo viene rifiutato con feature_not_in_plan (402). Il modello è disponibile in ogni piano.