Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este guia explica como ler e editar observações do apresentador usando a API Google Slides.
Páginas e modelos de anotações
Uma página de observações é um tipo de página usada para gerar folhetos para slides em uma apresentação. Cada slide tem uma página de observações. O primeiro marcador de posição BODY na página de observações de um slide contém o texto das observações do apresentador. Apenas o conteúdo de texto dessa forma de notas pode ser editado na API Slides. As outras propriedades e o restante do conteúdo da página de notas são somente leitura.
O modelo de anotações da apresentação é uma página que define os elementos padrão e os estilos de texto usados nas páginas de anotações. Uma apresentação tem apenas um modelo de anotações. Os modelos de anotações são somente leitura na API Slides.
Ler e gravar anotações do apresentador
Para encontrar o formato das anotações do apresentador de um slide, encontre o objeto
presentations.pages
das anotações do slide na mensagem
SlideProperties. A forma que contém o texto das anotações do apresentador é identificada pelo campo speakerNotesObjectId na mensagem NotesProperties da página de anotações.
Para ler as observações do apresentador de um slide, encontre um objeto com esse ID na página de observações
e leia o texto. Em casos raros, esse objeto pode não existir, o que significa que os slides não têm anotações do apresentador.
Você pode usar solicitações de texto batchUpdate
para modificar o texto dentro da forma das observações do apresentador. No raro caso em que a forma de observações do apresentador não existe, a API Slides a cria automaticamente quando recebe uma operação de texto válida usando um speakerNotesObjectId.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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`."]]
