Ce guide explique comment lire et modifier les notes du 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 à distribuer pour les diapositives d'une présentation. Chaque diapositive est associée à une page de notes. La première forme de l'espace réservé BODY sur la page de notes d'une diapositive contient le texte des notes du présentateur. 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 d'une 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 des notes. Les masques des notes sont en lecture seule dans l'API Slides.
Lire et écrire les 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 du présentateur est identifiée par le champ speakerNotesObjectId dans le message NotesProperties de la page de notes.
Pour lire les notes du présentateur d'une diapositive, recherchez un objet avec 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 ne comportent pas de notes du présentateur.
Vous pouvez utiliser des requêtes textuelles batchUpdate pour modifier le texte à l'intérieur de la forme des notes du présentateur. Dans le cas rare où la forme des notes du 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.