使用演講者備忘稿

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

筆記頁面和筆記母片

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

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

讀取及寫入演講者備忘稿

如要找出投影片的演講者備忘稿形狀，請在SlideProperties訊息中找出投影片的備忘稿 presentations.pages 物件。含有講者備註文字的形狀會由備註頁面 NotesProperties 訊息中的 speakerNotesObjectId 欄位識別。

如要讀取投影片的講者備註，請在備註頁面中找出具有此 ID 的物件，然後讀取其文字。在極少數情況下，這個物件可能不存在，也就是說簡報沒有演講者備忘稿。

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