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