Utiliser les commentaires du présentateur

Cette page explique comment lire et modifier les notes du présentateur à l'aide de l'API Slides.

Pages de notes et maîtres de notes

Une page de notes est un type de page utilisé pour générer des supports de cours pour les diapositives d'une présentation. Chaque diapositive est associée à une page de notes. Le texte des notes du présentateur d'une diapositive est contenu dans la première forme d'espace réservé BODY sur la page des notes de la diapositive. Seul le contenu textuel de cette forme de notes est modifiable dans l'API Slides. Ses autres propriétés et le reste du contenu de la page de notes sont en lecture seule.

Le maître des 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 maître des notes. Les maîtres de notes sont en lecture seule dans l'API Slides.

Lire et écrire des notes du présentateur

Pour trouver la forme des notes du présentateur d'une diapositive, recherchez la Page des notes de la diapositive dans le message SlideProperties. La forme contenant le texte des notes de l'orateur est identifiée par le champ speakerNotesObjectId dans le message NotesProperties de la page de notes.

Pour lire les notes de l'orateur d'une diapositive, recherchez un objet avec cet ID sur la page des 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 notes du présentateur. Dans les rares cas où la forme des notes du présentateur n'existe pas, l'API Slides la crée automatiquement lorsqu'elle détecte une opération de texte valide à l'aide d'un speakerNotesObjectId.