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

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

דפי הערות ודפי הערות ראשיים

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

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

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

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

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

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