使用演讲者备注

本指南介绍了如何使用 Google 幻灯片 API 读取和修改演讲者备注。

备注页和备注母版

备注页是一种用于为演示文稿中的幻灯片生成讲义的页面。每张幻灯片都有一个备注页。幻灯片备注页上的第一个 BODY 占位符形状包含幻灯片演讲者备注的文本。在幻灯片 API 中,只有此备注形状的文本内容可修改。其其他属性和备注页的其余内容都是只读的。

演示文稿的备注母版是一个页面,用于定义备注页上使用的默认元素和文本样式。一个演示文稿只有一个备注母版。备注母版在幻灯片 API 中是只读的。

读取和写入演讲者备注

如需查找幻灯片的演讲者备注形状,请在其 SlideProperties 消息中查找幻灯片的备注 presentations.pages 对象。包含演讲者备注文本的形状由备注页的 speakerNotesObjectId字段在 NotesProperties 消息中标识。

如需读取幻灯片的演讲者备注,请在备注页上查找具有此 ID 的对象 并读取其 文本。在极少数情况下,此对象可能不存在,这意味着幻灯片没有演讲者备注。

您可以使用 batchUpdate 文本请求 来修改演讲者备注形状内的文本。在极少数情况下,如果演讲者备注形状不存在,幻灯片 API 会在使用 speakerNotesObjectId 收到有效的文本操作时自动创建该形状。