スケジュールインポート API

スケジュールインポートが読む列と3つのサンプル行（スクリーンコード、スクリーンフォルダー、タグ）を含むシートを、CSV または format=xlsx を指定した場合は XLSX ワークブックとして返します。

スケジュール行のシートをプロジェクトに照らして読み取り、確定した場合に何が行われるかを返します。何も書き込みません。

各行には、対象（スクリーン ID、部屋コードなどのスクリーンフィールドの値、または名前によるスクリーン、folder:NAME、tag:NAME。複数の場合は ; または | で区切る）、コンテンツ（メディアファイル名、playlist:NAME、またはプレイリスト ID）、開始と終了（終了に日付だけを指定するとその日いっぱいで終了）を指定します。任意で timezone、days (Mon-Fri)、毎日の時間帯（daily_start、daily_end）、0から100の priority、名前、ディスプレイ番号も指定できます。

時刻は各スクリーン自身の時計で読み取られます。timezone 列で別のタイムゾーンから変換できます。

すべての行が検証され、エラーは列ごとに報告されます。不明または曖昧なスクリーン、フォルダー、タグ、存在しないまたは曖昧なファイル、スクリーンを満たせないファイル、無効または逆転した時刻、過去の終了、タイミングの指定がまったくない、タイムゾーンまたはデフォルトプレイリストのないスクリーン、同じ優先度でスクリーン上に同時に有効な2つの行、スクリーンが保持できる数（32）を超えるレベル、または組織がすべてのプロジェクトを合わせて保持できる数（100、共有レベルはそれぞれ1件に数えられます）を超えるキャンペーン。

コンテンツ、時刻、優先度、名前が一致する行は1つのレベルになります。1つのスクリーンはそのスクリーン自身のスケジュールのエントリになり、複数のスクリーン、フォルダー、タグは1つの共有レベル（キャンペーン）になり、スクリーン独自のレベルより優先されます。

応答には、確定が各レベルに行う処理（create、update、unchanged）とともにレベルが一覧表示されます。さらに、同じインポートの以前の実行で作成され、シートにはもうないレベル（removals）、スクリーンのスタックの確定後の状態（calendar）、確定に送信するフィンガープリントが含まれます。シートは JSON の行、CSV、または XLSX で、最大5,000行です。

スクリーンに限定された呼び出し元は利用できません（outside_screen_scope）。スケジュールインポートは Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。テンプレートはすべてのプランで利用できます。

プレビュー済みのインポートを確定します。同じシートと、そのプレビューが返したフィンガープリントを送信します。すべてのレベルが作成、更新、削除され、スクリーンのスケジュールと共有レベルが1つのトランザクションで書き込まれ、インポートイベント schedule.imported が追記されます。すべての行が適用されるか、まったく適用されないかのどちらかです。

シートのファイルに必要な1ファイルのプレイリストが最初に作成されます（どのスクリーンにも変更はありません）。行にエラーのあるシートは拒否されます（schedule_import_invalid）。プレビュー後にプロジェクトが変更された場合や、行の読み取り結果が変わった場合も拒否され（schedule_import_stale）、クライアントはもう一度プレビューします。

同じ名前で同じシートを再度インポートしても何も変わりません。変更された行はそのレベルを更新し、削除された行はそのレベルを削除します。ダッシュボードで承認できるユーザーと、エージェント用の書き込みアクセスを持つ認証情報が必要です。

確保済みキャンペーンを更新または削除するコミットは、承認できる人がコミットしない限り、reserved_item（403）を返し、何も書き込みません。

保護されたスクリーンに及ぶコミットは、インポートにレベルがなくても、保護されたスクリーンのインポートエントリを削除する場合や、対象が保護されたスクリーンに及ぶインポートキャンペーンを削除する場合に、protected_target で全体が拒否されます。

保護されたスクリーンフォルダーのあるプロジェクトでは、プレビューがシートではなくサービスで失敗するコミットは dependency_unavailable で応答し、何も書き込みません。少し待って同じリクエストをもう一度送信してください。シート、キャンペーン、スクリーンの検証エラーは、コミット時と同じように応答されます（invalid_request と上記のその他の問題）。

スクリーンに限定された呼び出し元は利用できません。スケジュールインポートは Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。テンプレートはすべてのプランで利用できます。