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

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

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

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

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

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

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

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

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