Mit Vortragsnotizen arbeiten

In dieser Anleitung wird beschrieben, wie Sie mit der Google Präsentationen API Sprechernotizen lesen und bearbeiten.

Notizenseiten und Notizenmaster

Eine Notizenseite ist eine Art 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 Folien-Sprechernotizen. In der Präsentationen API kann nur der Textinhalt dieser Notizenform bearbeitet werden. Die anderen Eigenschaften und der Rest des Inhalts der Notizenseite sind schreibgeschützt.

Der Notizenmaster der Präsentation ist eine Seite, auf der die Standardelemente und Textstile für Notizenseiten definiert werden. Eine Präsentation hat nur einen Notizenmaster. Notizenmaster sind in der Google Präsentationen API schreibgeschützt.

Vortragsnotizen lesen und schreiben

Die Form der Vortragsnotizen einer Folie finden Sie im Notizenobjekt presentations.pages der SlideProperties-Nachricht der Folie. Die Form mit dem Text der Sprechernotizen wird durch das Feld speakerNotesObjectId in der Nachricht NotesProperties der Notizenseite identifiziert.

Wenn Sie die Sprechernotizen 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 Sprechernotizen haben.

Mit Textanfragen von batchUpdate können Sie den Text im Bereich für Sprechernotizen ändern. In dem seltenen Fall, dass die Form für die Sprechernotizen nicht vorhanden ist, erstellt die Präsentationen API sie automatisch, wenn sie einen gültigen Textvorgang mit einer speakerNotesObjectId empfängt.