使用演讲者备注

本页将介绍如何使用幻灯片 API 阅读和编辑演讲者备注。

记事页面和记事母版

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

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

读取和写入演讲者备注

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

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

您可以使用 text batchUpdate 请求修改演讲者备注形状中的文本。在没有演讲者备注形状的极少数情况下，Slides API 会在看到有效的文本操作时使用 speakerNotesObjectId 自动创建演讲者备注。