In diesem Leitfaden wird erläutert, wie Sie mit der Google Slides API Referentennotizen 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 der Folie. In der Slides API kann nur der Textinhalt dieser Notizenform bearbeitet werden. Die anderen Eigenschaften und der restliche Inhalt der Notizenseite sind schreibgeschützt.
Der Notizenmaster der Präsentation ist eine Seite, auf der die Standardelemente und Textstile definiert sind, die auf Notizenseiten verwendet werden. Eine Präsentation hat nur einen Notizenmaster. Notizenmaster sind in der Slides API schreibgeschützt.
Referentennotizen lesen und schreiben
Um die Form für die Referentennotizen einer Folie zu finden, suchen Sie in der Nachricht
SlideProperties
nach dem Objekt
presentations.pages
der Notizen der Folie. Die Form mit dem Text der Referentennotizen wird durch das
speakerNotesObjectId Feld 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 den Text. In seltenen Fällen ist dieses Objekt möglicherweise nicht vorhanden. Das bedeutet, dass die Folien keine Referentennotizen haben.
Sie können batchUpdate Textanfragen
verwenden, um den Text in der Form für die Referentennotizen zu ändern. In dem seltenen Fall, dass die Form für die Referentennotizen nicht vorhanden ist, wird sie von der Slides API automatisch erstellt, wenn sie eine gültige Textoperation mit einer speakerNotesObjectId empfängt.