Utiliser les commentaires du présentateur

Ce guide explique comment lire et modifier les notes du présentateur à l'aide de l'API Google 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. La première forme d'espace réservé BODY sur la page des notes d'une diapositive contient le texte des notes de l'orateur. 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 modèles de notes sont en lecture seule dans l'API Slides.

Lire et écrire des commentaires du présentateur

Pour trouver la forme des notes du présentateur d'une diapositive, recherchez l'objet presentations.pages des notes de la diapositive dans son 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 portant cet ID sur la page des notes et lisez son texte. Dans de rares cas, cet objet peut ne pas exister, ce qui signifie que les diapositives n'ont pas de notes pour l'orateur.

Vous pouvez utiliser des requêtes de texte batchUpdate pour modifier le texte dans la forme des notes de l'orateur. Dans les rares cas où la forme des notes de l'orateur n'existe pas, l'API Slides la crée automatiquement lorsqu'elle reçoit une opération de texte valide à l'aide d'un speakerNotesObjectId.