使用演講者備忘稿

本頁面說明如何使用簡報 API 讀取及編輯講者備註。

筆記頁面和筆記母片

備註頁面是一種用於產生簡報中投影片的講義的頁面。每個投影片都會有一個筆記頁面。投影片的講者備註文字會包含在投影片備註頁面上的第一個 BODY 預留位置形狀中。在 Google 簡報 API 中,只有備忘稿形狀的文字內容可供編輯。其其他屬性和其他筆記頁面內容皆為唯讀。

簡報的備註母片是定義備註頁面所用預設元素和文字樣式的頁面。每份簡報只有一個備忘稿母片。在 Slides API 中,筆記母片為唯讀。

讀取及寫入演講者備忘稿

如要找出投影片的演講者備忘稿形狀,請在「SlideProperties」SlideProperties訊息中找出投影片的備忘稿 Page。含有講者備註文字的形狀會由備註頁面的「NotesProperties」NotesProperties訊息中的 speakerNotesObjectId 欄位識別。

如要讀取投影片的講者備註,請在備註頁面上找出這個 ID 的物件,然後讀取其文字。在少數情況下,這個物件不會存在,表示簡報沒有演講者備忘稿。

你可以使用 text batchUpdate 要求修改演講者備註形狀中的文字。在極少數情況下,如果講者筆記形狀不存在,當 Google 簡報 API 看到使用 speakerNotesObjectId 的有效文字作業時,就會自動建立該形狀。