Trabalhar com anotações do apresentador

Este guia explica como ler e editar notas do orador usando a API Google Slides.

Páginas de notas e notas principais

Uma página de anotações é um tipo de página usada para gerar distribuições de slides em uma apresentação. Cada slide tem uma página de anotações. A primeira forma de marcador de posição BODY na página de anotações de um slide contém o texto das anotações do orador de um slide. Somente o conteúdo de texto dessa forma de anotação pode ser editado na API Slides. As outras propriedades e o restante do conteúdo da página de anotações são somente leitura.

A página principal 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 uma página principal de anotações. As páginas mestres de notas são somente leitura na API Slides.

Ler e gravar anotações do apresentador

Para encontrar a forma de anotação do apresentador de um slide, encontre o objeto presentations.pages de anotações do slide na mensagem SlideProperties. A forma que contém o texto das notas do orador é identificada pelo campo speakerNotesObjectId na mensagem NotesProperties da página de notas.

Para ler as anotações do orador de um slide, encontre um objeto com esse ID na página de anotações e leia o texto. Em casos raros, esse objeto pode não existir, o que significa que os slides não têm notas do orador.

É possível usar solicitações de texto batchUpdate para modificar o texto dentro do formato de anotações do orador. No caso raro em que a forma de anotações do orador não existe, a API Slides a cria automaticamente quando recebe uma operação de texto válida usando um speakerNotesObjectId.