Slide 投影片排序、編輯、複製與衝突
list_slides 回傳完整有序序列。add_slide 未提供 afterSlideId 時加在最後,提供時緊接指定投影片;找不到 anchor 回 resource_not_found。省略 content 會建立空白 version 2 slide。duplicate_slide 複製來源 content 與講者備註,可用 title 覆寫標題,並把複本放在來源正後方。
update_slide 使用 optimistic locking,必須帶剛讀到的整數 expectedVersion;只有提供的 title、content、speakerNotes 會改,成功後 row version 加一。content 是整份取代而非 element merge,改一個元素也要送回完整 elements 陣列。值過舊會回含 currentVersion 的 resource_conflict;應重讀、合併,再用新值重試,不可原封重送。這個 row version 與 deck-level history Actions 無關。content 與 speaker notes 會從 Action audit plaintext redact。
reorder_slides 必須正好包含目前每個 slide ID 一次,不得漏掉、重複或混入其他簡報的 ID;提供的陣列會原子地成為完整新順序。delete_slide 需要 UserConfirm,且不能刪最後一張;要替換唯一頁面需先新增再刪。每個 deck 最多 200 張;達上限後 add/duplicate 回 typed resource conflict。併發編輯後以 Action 結果與持久化狀態為準。
Related actions
Section titled “Related actions”arinova.slide.list_slides, arinova.slide.add_slide, arinova.slide.update_slide, arinova.slide.delete_slide, arinova.slide.reorder_slides, arinova.slide.duplicate_slide
Also known as
新增投影片, 調整投影片順序, 複製投影片, 投影片版本衝突, expectedVersion, 講者備註
Build a7f47a5ca54ddcf7806cd48b81ce1b9827042766