Cette page explique comment lire et modifier les commentaires du présentateur à l'aide de l'API Slides.
Pages de notes et masques de notes
Une page de notes est un type de page permettant de générer des documents pour les diapositives d'une présentation. Chaque diapositive a une page de notes. Le texte des commentaires du présentateur d'une diapositive contient la première forme d'espace réservé BODY sur la page de notes d'une diapositive. Seul le contenu textuel de cette forme de note peut être modifié dans l'API Slides. Ses autres propriétés et le reste du contenu de la page de notes sont en lecture seule.
Le masque de notes de la présentation est une page qui définit les éléments et les styles de texte par défaut utilisés sur les pages de notes. Une présentation ne comporte qu'un seul masque de notes. Les messages maîtres Notes sont en lecture seule dans l'API Slides.
Lire et écrire les commentaires du présentateur
Pour trouver la forme de la note du présentateur d'une diapositive, recherchez la page des notes dans le message SlideProperties. La forme contenant le texte des commentaires du présentateur est identifiée par le champ speakerNotesObjectId dans le message NotesProperties de la page de notes.
Pour lire les commentaires du présentateur d'une diapositive, recherchez un objet portant cet ID sur la page de notes et lisez son texte. Dans de rares cas, cet objet n'existera pas, ce qui signifie que les diapositives ne comportent pas de commentaires du présentateur.
Vous pouvez utiliser les requêtes text batchUpdate pour modifier le texte dans la forme des commentaires du présentateur. Dans les rares cas où la forme des commentaires du présentateur n'existe pas, l'API Slides la crée automatiquement lorsqu'elle voit une opération textuelle valide à l'aide d'un speakerNotesObjectId.