Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Work with speaker notes\n\nThis guide explains how to read and edit speaker notes using the Google Slides API.\n\nNotes pages and notes masters\n-----------------------------\n\nA notes page is a kind of page used for generating handouts for slides in a\npresentation. Each slide has one notes page. The first `BODY` placeholder shape\non a slide's notes page contains the text of a slide's speaker notes. Only the\ntext content of this notes shape is editable in Slides API. Its other\nproperties and the rest of the notes page contents are read-only.\n\nThe presentation's notes master is a page that defines the default elements and\ntext styles used on notes pages. A presentation only has one notes master. Notes\nmasters are read-only in the Slides API.\n\nRead and write speaker notes\n----------------------------\n\nTo find a slide's speaker note shape, find the slide's notes\n[`presentations.pages`](/workspace/slides/api/reference/rest/v1/presentations.pages)\nobject in its\n[`SlideProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#slideproperties)\nmessage. The shape containing the speaker notes text is identified by the\n`speakerNotesObjectId` field in the notes page's\n[`NotesProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#notesproperties)\nmessage.\n\nTo read a slide's speaker notes, find an object with this ID on the notes page\nand read its [text](/workspace/slides/api/concepts/text). In rare cases, this\nobject might not exist which means the slides have no speaker notes.\n\nYou can use [`batchUpdate`](/workspace/slides/api/guides/styling) text requests\nto modify the text inside the speaker notes shape. In the rare case where the\nspeaker notes shape doesn't exist, the Slides API creates it\nautomatically when it receives a valid text operation using a\n`speakerNotesObjectId`."]]
