Cette page vous 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 utilisée pour générer des documents à utiliser pour les diapositives d'une présentation. Chaque diapositive contient 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 notes 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 possède qu'un seul masque de notes. Les masques Notes sont en lecture seule dans l'API Slides.
Lire et rédiger les commentaires du présentateur
Pour afficher la forme des commentaires du présentateur d'une diapositive, recherchez la Page des notes de la diapositive 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'existe 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.