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