עבודה עם הערות הדובר

בדף הזה מוסבר איך לקרוא ולערוך את הערות הדובר באמצעות ה-API של Slides.

מאסטרים של דפי הערות והערות

דף הערות הוא סוג של דף שמשמש ליצירת דפי מידע לשקפים במצגת. בכל שקף יש דף הערות אחד. הטקסט של הערות הדובר בשקף מכיל את הצורה הראשונה של ה-placeholder BODY בדף ההערות בשקף. ב-Slides API אפשר לערוך רק את תוכן הטקסט של צורת ההערות הזו. המאפיינים האחרים שלו ושאר התוכן של דף ההערות מוגדרים לקריאה בלבד.

המאסטר להערות במצגת הוא דף שמגדיר את רכיבי ברירת המחדל ואת סגנונות הטקסט בדפי ההערות. לכל מצגת יש מאסטר אחד של הערות בלבד. המאסטרים של הפתקים זמינים לקריאה בלבד ב-Slides API.

קריאה וכתיבה של הערות הדובר

כדי לבדוק את הצורה של הערות הדובר בשקף, צריך לחפש את ההערות בקטע Page (דף) בשקף שמופיע בהודעה SlideProperties. הצורה שמכילה את הטקסט של הערות הדובר מזוהה באמצעות השדה speakerNotesObjectId בהודעה NotesProperties בדף ההערות.

כדי לקרוא את הערות הדובר בשקף, צריך לחפש אובייקט עם המזהה הזה בדף ההערות ולקרוא את הטקסט שלו. במקרים נדירים, האובייקט הזה לא יהיה קיים, כלומר בשקפים אין הערות דובר.

תוכלו להשתמש בבקשות text bundleUpdate כדי לשנות את הטקסט בתוך הצורה של הערות הדובר. במקרים הנדירים שבהם הצורה של הערות הדובר לא קיימת, Slides API יוצר אותה באופן אוטומטי כשהוא מזהה פעולת טקסט חוקית באמצעות speakerNotesObjectId.