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