本指南說明如何使用 Google 簡報 API 讀取及編輯講者備忘稿。
備忘稿和備忘稿母片
備註頁面是一種頁面,用於為簡報中的投影片產生講義。每張投影片都有一個備註頁面。投影片備忘稿頁面的第一個 BODY 預留位置圖案,會包含投影片講者備忘稿的文字。只有這個附註圖案的文字內容可透過 Google 簡報 API 編輯。其他屬性和記事頁面其餘內容則為唯讀。
簡報的備忘稿母片是定義備忘稿頁面所用預設元素和文字樣式的頁面。簡報只能有一個備忘稿母片。在 Google Slides API 中,附註母片為唯讀。
讀取及寫入演講者備忘稿
如要找出投影片的演講者備忘稿形狀,請在訊息中找出投影片的備忘稿 presentations.pages 物件。SlideProperties含有演講者備忘稿文字的圖案,是由備忘稿頁面訊息中的 speakerNotesObjectId 欄位識別。NotesProperties
如要讀取投影片的演講者備忘稿,請在備忘稿頁面中找出具有這個 ID 的物件,然後讀取其 text。在極少數情況下,這個物件可能不存在,也就是說投影片沒有演講者備忘稿。
你可以使用 batchUpdate 文字要求修改演講者備忘稿形狀內的文字。如果講者備忘稿形狀不存在 (極少發生),當 Slides API 收到使用 speakerNotesObjectId 的有效文字作業時,就會自動建立該形狀。