با یادداشت های سخنران کار کنید
این راهنما نحوه خواندن و ویرایش یادداشت های گوینده را با استفاده از Google Slides API توضیح می دهد.
صفحات یادداشت ها و استادان یادداشت ها
صفحه یادداشت ها نوعی صفحه است که برای ایجاد جزوه برای اسلایدها در ارائه استفاده می شود. هر اسلاید دارای یک صفحه یادداشت است. اولین شکل مکان‌نمای BODY در صفحه یادداشت‌های اسلاید حاوی متن یادداشت‌های سخنران یک اسلاید است. فقط محتوای متنی این شکل یادداشت ها در Slides API قابل ویرایش است. سایر ویژگی‌های آن و بقیه محتوای صفحه یادداشت‌ها فقط خواندنی هستند.
استاد یادداشت های ارائه صفحه ای است که عناصر پیش فرض و سبک های متن مورد استفاده در صفحات یادداشت ها را تعریف می کند. یک ارائه فقط یک استاد یادداشت دارد. Master Notes در Slides API فقط خواندنی است.
یادداشت های سخنران را بخوانید و بنویسید
برای یافتن شکل یادداشت بلندگوی اسلاید، شیء اسلایدها را در presentations.pages در پیام SlideProperties آن بیابید. شکل حاوی متن یادداشت‌های بلندگو با فیلد speakerNotesObjectId در پیام NotesProperties صفحه یادداشت‌ها مشخص می‌شود.
برای خواندن یادداشت‌های سخنران یک اسلاید، یک شی با این شناسه را در صفحه یادداشت‌ها پیدا کنید و متن آن را بخوانید. در موارد نادر، این شیء ممکن است وجود نداشته باشد، به این معنی که اسلایدها هیچ یادداشت بلندگو ندارند.
می‌توانید از درخواست‌های متنی batchUpdate برای تغییر متن داخل شکل یادداشت‌های گوینده استفاده کنید. در موارد نادری که شکل یادداشت‌های بلندگو وجود ندارد، Slides API زمانی که یک عملیات متنی معتبر با استفاده از speakerNotesObjectId دریافت می‌کند، آن را به‌طور خودکار ایجاد می‌کند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-02-14 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-02-14 بهوقت ساعت هماهنگ جهانی."],[[["This page explains how to utilize the Slides API to view and modify speaker notes associated with presentation slides."],["Each slide's speaker notes are stored within a designated shape on its corresponding notes page, accessible via the `speakerNotesObjectId`."],["You can read speaker notes by locating the shape with the `speakerNotesObjectId` and accessing its text content."],["Modifying speaker notes involves using text batchUpdate requests to edit the text within the identified speaker notes shape."],["If a speaker notes shape is missing, the Slides API will automatically generate one upon receiving a valid text operation using the `speakerNotesObjectId`."]]],["The Google Slides API allows reading and editing of speaker notes, which are found on a slide's notes page. The `speakerNotesObjectId` in the `NotesProperties` identifies the shape containing the notes text. You can use API calls to read text within this shape. While the notes master (read-only) defines default elements, you can edit the speaker notes text using `batchUpdate` requests. The API automatically creates the speaker notes shape if it's missing upon receiving a text operation.\n"]]
