Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Z tego przewodnika dowiesz się, jak odczytywać i edytować notatki dla prelegenta za pomocą interfejsu Google Slides API.
Strony notatek i wzorce notatek
Strona notatek to rodzaj strony używanej do generowania materiałów do rozdania do slajdów w prezentacji. Każdy slajd ma jedną stronę notatek. Pierwszy kształt zastępczy BODY na stronie notatek slajdu zawiera tekst notatek prelegenta. W interfejsie Slides API można edytować tylko treść tekstową tego kształtu notatek. Pozostałe właściwości i zawartość strony z notatkami są tylko do odczytu.
Wzorzec notatek prezentacji to strona, która określa domyślne elementy i style tekstu używane na stronach notatek. Prezentacja ma tylko jeden wzorzec notatek. W interfejsie Slides API wzorce notatek są dostępne tylko do odczytu.
Odczytywanie i zapisywanie notatek
Aby znaleźć kształt notatki do slajdu, odszukaj obiekt notatek do slajdu w wiadomości presentations.pagesSlideProperties. Kształt zawierający tekst notatek prelegenta jest identyfikowany przez pole speakerNotesObjectId w wiadomości NotesProperties na stronie notatek.
Aby przeczytać notatki prelegenta do slajdu, znajdź obiekt o tym identyfikatorze na stronie notatek i przeczytaj jego tekst. W rzadkich przypadkach ten obiekt może nie istnieć, co oznacza, że slajdy nie mają notatek.
Możesz używać batchUpdate żądań tekstowych, aby modyfikować tekst w kształcie notatek prelegenta. W rzadkich przypadkach, gdy kształt notatek prelegenta nie istnieje, interfejs Slides API tworzy go automatycznie, gdy otrzyma prawidłową operację tekstową z użyciem speakerNotesObjectId.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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`."]]
