קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במדריך הזה מוסבר איך לקרוא ולערוך הערות דובר באמצעות Google Slides API.
דפי הערות ודפי הערות ראשיים
דף הערות הוא סוג של דף שמשמש ליצירת חומרים מחולקים לשקפים במצגת. לכל שקף יש דף הערות אחד. הצורה הראשונה של ה-placeholder BODY בדף ההערות של השקף מכילה את הטקסט של הערות הדובר של השקף. אפשר לערוך ב-Slides API רק את תוכן הטקסט של צורת ההערה הזו. שאר המאפיינים שלה ושאר התוכן בדף ההערות הם לקריאה בלבד.
דף האב של ההערות במצגת הוא דף שמגדיר את רכיבי ברירת המחדל ואת סגנונות הטקסט שמשמשים בדפי ההערות. למצגת יש רק שקף ראשי אחד של הערות. הערות
המאסטר הן לקריאה בלבד ב-Slides API.
קריאה וכתיבה של הערות הדובר
כדי למצוא את הצורה של הערת הדובר בשקף, מחפשים את אובייקט ההערות presentations.pages של השקף בהודעה SlideProperties שלו. הצורה שמכילה את הטקסט של הערות הדובר מזוהה על ידי השדה speakerNotesObjectId בהודעה של דף ההערות NotesProperties.
כדי לקרוא את הערות הדובר בשקף, מחפשים אובייקט עם המזהה הזה בדף ההערות וקוראים את הטקסט שלו. במקרים נדירים, יכול להיות שהאובייקט הזה לא קיים, כלומר בשקפים אין הערות דובר.
אפשר להשתמש בבקשות טקסט של batchUpdate כדי לשנות את הטקסט בתוך הצורה של הערות הדובר. במקרים נדירים שבהם הצורה של הערות הדובר לא קיימת, Slides API יוצר אותה באופן אוטומטי כשהוא מקבל פעולת טקסט תקינה באמצעות speakerNotesObjectId.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 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`."]]
