Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta guía, se explica cómo leer y editar notas del orador con la API de Google Slides.
Páginas de notas y patrones de notas
Una página de notas es un tipo de página que se usa para generar folletos de diapositivas en una presentación. Cada diapositiva tiene una página de notas. La primera forma de marcador de posición BODY en la página de notas de una diapositiva contiene el texto de las notas del orador de la diapositiva. Solo el contenido de texto de esta forma de notas se puede editar en la API de Slides. Sus otras propiedades y el resto del contenido de la página de notas son de solo lectura.
La página patrón de notas de la presentación es una página que define los elementos predeterminados y los estilos de texto que se usan en las páginas de notas. Una presentación solo tiene un patrón de notas. Las notas del orador son de solo lectura en la API de Slides.
Leer y escribir notas del orador
Para encontrar la forma de las notas del orador de una diapositiva, busca el objeto presentations.pages de las notas de la diapositiva en su mensaje SlideProperties. La forma que contiene el texto de las notas del orador se identifica con el campo speakerNotesObjectId en el mensaje NotesProperties de la página de notas.
Para leer las notas del orador de una diapositiva, busca un objeto con este ID en la página de notas y lee su texto. En casos excepcionales, es posible que este objeto no exista, lo que significa que las diapositivas no tienen notas del orador.
Puedes usar solicitudes de texto de batchUpdate para modificar el texto dentro de la forma de notas del orador. En el caso poco frecuente en el que no existe la forma de las notas del orador, la API de Slides la crea automáticamente cuando recibe una operación de texto válida con un speakerNotesObjectId.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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`."]]
