In diesem Leitfaden wird erläutert, wie Sie mit der Google Slides API Sprechernotizen lesen und bearbeiten.
Notizenseiten und Notizenmaster
Eine Notizenseite ist eine Art von Seite, die zum Erstellen von Handouts für Folien in einer Präsentation verwendet wird. Jede Folie hat eine Notizenseite. Die erste BODY-Platzhalterform auf der Notizenseite einer Folie enthält den Text der Referentennotizen einer Folie. Nur der Textinhalt dieser Notizenform kann in der Slides API bearbeitet werden. Die anderen Eigenschaften und der restliche Inhalt der Notizenseite sind schreibgeschützt.
Der Notizenmaster einer Präsentation ist eine Seite, auf der die Standardelemente und Textformatierungen für Notizenseiten definiert werden. Eine Präsentation hat nur ein Notizenmaster. Notizenmaster sind in der Slides API schreibgeschützt.
Vortragsnotizen lesen und schreiben
Die Form der Vortragsnotizen einer Folie finden Sie im presentations.pages-Objekt der Folie in der Nachricht SlideProperties. Die Form mit dem Text der Notizen wird durch das Feld speakerNotesObjectId in der Nachricht NotesProperties der Notizenseite identifiziert.
Wenn Sie die Referentennotizen einer Folie lesen möchten, suchen Sie auf der Notizenseite nach einem Objekt mit dieser ID und lesen Sie dessen text. In seltenen Fällen ist dieses Objekt möglicherweise nicht vorhanden, was bedeutet, dass die Folien keine Rednernotizen enthalten.
Sie können batchUpdate-Textanfragen verwenden, um den Text im Feld für Referentennotizen zu ändern. In dem seltenen Fall, dass die Form für Notizen nicht vorhanden ist, wird sie von der Slides API automatisch erstellt, wenn sie einen gültigen Textvorgang mit einem speakerNotesObjectId empfängt.