Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida spiega come leggere e modificare le note del relatore utilizzando l'API Google Slides.
Pagine delle note e master delle note
Una pagina di note è un tipo di pagina utilizzato per generare i materiali di distribuzione per le slide di una
presentazione. Ogni slide ha una pagina di note. La prima forma segnaposto BODY
nella pagina delle note di una slide contiene il testo delle note del relatore di una slide. Solo il
contenuto di testo di questa forma delle note è modificabile nell'API Slides. Le altre
proprietà e il resto dei contenuti della pagina delle note sono di sola lettura.
Lo schema delle note della presentazione è una pagina che definisce gli elementi predefiniti e
gli stili di testo utilizzati nelle pagine delle note. Un file di presentazione ha un solo master delle note. I master
delle note sono di sola lettura nell'API Slides.
Legge e modifica le note del relatore
Per trovare la forma delle note del relatore di una slide, individua l'oggetto
presentations.pages
delle note della slide
nel messaggio
SlideProperties. La forma contenente il testo delle note del relatore è identificata dal campo
speakerNotesObjectId nel messaggio
NotesProperties
della pagina delle note.
Per leggere le note del relatore di una slide, trova un oggetto con questo ID nella pagina delle note
e leggi il relativo testo. In rari casi, questo
oggetto potrebbe non esistere, il che significa che le slide non hanno note del relatore.
Puoi utilizzare le richieste di testo batchUpdate
per modificare il testo all'interno della forma delle note del relatore. Nel raro caso in cui la forma delle note del relatore non esista, l'API Slides la crea automaticamente quando riceve un'operazione di testo valida utilizzando un speakerNotesObjectId.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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`."]]
