این راهنما نحوه خواندن و ویرایش یادداشتهای گوینده را با استفاده از API اسلایدهای گوگل توضیح میدهد.
صفحات یادداشتها و یادداشتهای اصلی
صفحه یادداشتها نوعی صفحه است که برای ایجاد جزوات برای اسلایدها در یک ارائه استفاده میشود. هر اسلاید دارای یک صفحه یادداشت است. اولین شکل BODY در صفحه یادداشتهای اسلاید شامل متن یادداشتهای گوینده اسلاید است. فقط محتوای متنی این شکل یادداشتها در API اسلایدها قابل ویرایش است. سایر ویژگیهای آن و بقیه محتوای صفحه یادداشتها فقط خواندنی هستند.
صفحه اصلی یادداشتهای ارائه، صفحهای است که عناصر پیشفرض و سبکهای متنی مورد استفاده در صفحات یادداشت را تعریف میکند. هر ارائه فقط یک صفحه اصلی یادداشت دارد. صفحات اصلی یادداشتها در رابط برنامهنویسی کاربردی اسلایدها (Slides API) فقط قابل خواندن هستند.
خواندن و نوشتن یادداشتهای سخنران
برای یافتن شکل یادداشت گوینده یک اسلاید، شیء notes presentations.pages اسلاید را در پیام SlideProperties آن پیدا کنید. شکلی که حاوی متن یادداشتهای گوینده است، توسط فیلد speakerNotesObjectId در پیام NotesProperties صفحه یادداشتها شناسایی میشود.
برای خواندن یادداشتهای گوینده یک اسلاید، شیءای با این شناسه را در صفحه یادداشتها پیدا کنید و متن آن را بخوانید. در موارد نادر، ممکن است این شیء وجود نداشته باشد، به این معنی که اسلایدها هیچ یادداشت گویندهای ندارند.
شما میتوانید از درخواستهای متنی batchUpdate برای تغییر متن داخل شکل یادداشتهای گوینده استفاده کنید. در موارد نادری که شکل یادداشتهای گوینده وجود ندارد، API اسلایدها هنگام دریافت یک عملیات متنی معتبر با استفاده از speakerNotesObjectId ، آن را به طور خودکار ایجاد میکند.