Como trabalhar com as anotações do apresentador

Esta página explica como ler e editar notas do orador usando a API Slides.

Páginas de notas e notas principais

Uma página de anotações é um tipo de página usada para gerar folhetos para slides em uma apresentação. Cada slide tem uma página de anotações. O texto das anotações do orador de um slide está contido na primeira forma de marcador de posição BODY na página de anotações de um slide. Somente o conteúdo de texto dessa forma de anotações pode ser editado na API Slides. As outras propriedades e o restante do conteúdo da página de notas 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 de anotações são de leitura somente na API Slides.

Como ler e gravar anotações do apresentador

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

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 não existe, o que significa que os slides não têm anotações do orador.

Use as solicitações text batchUpdate para modificar o texto dentro da forma 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 detecta uma operação de texto válida usando um speakerNotesObjectId.