Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Leitfaden wird erläutert, wie Sie mit der Google Slides API Rednernotizen lesen und bearbeiten.
Notizenseiten und Notizenmaster
Eine Notizenseite ist eine Art von Seite, die zum Generieren 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 Rest der Inhalte der Notizenseite sind schreibgeschützt.
Die Notizenmaster-Folie 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 Notizen der Folie in der SlideProperties-Nachricht. 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 Notizen für den Vortragenden enthalten.
Sie können batchUpdate-Textanfragen verwenden, um den Text im Form der Referentennotizen zu ändern. In dem seltenen Fall, dass die Form für Sprechernotizen nicht vorhanden ist, wird sie von der Slides API automatisch erstellt, wenn sie einen gültigen Textvorgang mit einem speakerNotesObjectId empfängt.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[],[],null,["# Work with speaker notes\n\nThis guide explains how to read and edit speaker notes using the Google Slides API.\n\nNotes pages and notes masters\n-----------------------------\n\nA notes page is a kind of page used for generating handouts for slides in a\npresentation. Each slide has one notes page. The first `BODY` placeholder shape\non a slide's notes page contains the text of a slide's speaker notes. Only the\ntext content of this notes shape is editable in Slides API. Its other\nproperties and the rest of the notes page contents are read-only.\n\nThe presentation's notes master is a page that defines the default elements and\ntext styles used on notes pages. A presentation only has one notes master. Notes\nmasters are read-only in the Slides API.\n\nRead and write speaker notes\n----------------------------\n\nTo find a slide's speaker note shape, find the slide's notes\n[`presentations.pages`](/workspace/slides/api/reference/rest/v1/presentations.pages)\nobject in its\n[`SlideProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#slideproperties)\nmessage. The shape containing the speaker notes text is identified by the\n`speakerNotesObjectId` field in the notes page's\n[`NotesProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#notesproperties)\nmessage.\n\nTo read a slide's speaker notes, find an object with this ID on the notes page\nand read its [text](/workspace/slides/api/concepts/text). In rare cases, this\nobject might not exist which means the slides have no speaker notes.\n\nYou can use [`batchUpdate`](/workspace/slides/api/guides/styling) text requests\nto modify the text inside the speaker notes shape. In the rare case where the\nspeaker notes shape doesn't exist, the Slides API creates it\nautomatically when it receives a valid text operation using a\n`speakerNotesObjectId`."]]
