使用演讲者备注

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

记事页面和记事母版

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

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

读取和写入演讲者备注

如需查找幻灯片的演讲者备注形状，请在其 SlideProperties 消息中查找幻灯片的备注 Page。包含演讲者备注文本的形状由记事页的 NotesProperties 消息中的 speakerNotesObjectId 字段标识。

如需阅读幻灯片的演示文稿，请在“备注”页面上找到具有此 ID 的对象，然后阅读其文本。在极少数情况下，此对象不存在，这意味着幻灯片没有演讲者备注。

您可以使用文本批量更新请求修改讲者备注形状中的文本。在极少数情况下，如果演讲者备注形状不存在，当 Slides API 看到使用 speakerNotesObjectId 的有效文本操作时，会自动创建该形状。