با یادداشت های سخنران کار کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این راهنما نحوه خواندن و ویرایش یادداشت های گوینده را با استفاده از 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-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Work with speaker notes\n\nThis guide explains how to read and edit speaker notes using the Google Slides API.\n\nNotes pages and notes masters\n-----------------------------\n\nA notes page is a kind of page used for generating handouts for slides in a\npresentation. Each slide has one notes page. The first `BODY` placeholder shape\non a slide's notes page contains the text of a slide's speaker notes. Only the\ntext content of this notes shape is editable in Slides API. Its other\nproperties and the rest of the notes page contents are read-only.\n\nThe presentation's notes master is a page that defines the default elements and\ntext styles used on notes pages. A presentation only has one notes master. Notes\nmasters are read-only in the Slides API.\n\nRead and write speaker notes\n----------------------------\n\nTo find a slide's speaker note shape, find the slide's notes\n[`presentations.pages`](/workspace/slides/api/reference/rest/v1/presentations.pages)\nobject in its\n[`SlideProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#slideproperties)\nmessage. The shape containing the speaker notes text is identified by the\n`speakerNotesObjectId` field in the notes page's\n[`NotesProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#notesproperties)\nmessage.\n\nTo read a slide's speaker notes, find an object with this ID on the notes page\nand read its [text](/workspace/slides/api/concepts/text). In rare cases, this\nobject might not exist which means the slides have no speaker notes.\n\nYou can use [`batchUpdate`](/workspace/slides/api/guides/styling) text requests\nto modify the text inside the speaker notes shape. In the rare case where the\nspeaker notes shape doesn't exist, the Slides API creates it\nautomatically when it receives a valid text operation using a\n`speakerNotesObjectId`."]]
