Utiliser les commentaires du présentateur

Ce guide explique comment lire et modifier des notes de présentateur à l'aide de l'API Google Slides.

Pages de notes et masques des notes

Une page de notes est un type de page utilisé pour générer des documents pour les diapositives d'une présentation. Chaque diapositive comporte une page de notes. La première forme d'espace réservé BODY sur la page de notes d'une diapositive contient le texte des notes de présentateur 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 masque des notes de la présentation est une page qui définit les éléments par défaut et les styles de texte utilisés sur les pages de notes. Une présentation ne comporte qu'un seul masque des notes. Les masques des notes sont en lecture seule dans l'API Slides.

Lire et écrire des notes de présentateur

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

Pour lire les notes de présentateur d'une diapositive, recherchez un objet avec cet ID sur la page de notes et lisez son texte. Dans de rares cas, cet objet peut ne pas exister, ce qui signifie que les diapositives ne comportent pas de notes de présentateur.

Vous pouvez utiliser batchUpdate des requêtes de texte pour modifier le texte à l'intérieur de la forme des notes de présentateur. Dans le cas rare où la forme des notes de présentateur 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.