استخدام ملاحظات المحاضر
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا الدليل كيفية قراءة ملاحظات المحاضر وتعديلها باستخدام Google Slides API.
صفحات الملاحظات والصفحات الرئيسية للملاحظات
صفحة الملاحظات هي نوع من الصفحات يُستخدَم لإنشاء نُسخ مطبوعة للشرائح في عرض تقديمي. تحتوي كل شريحة على صفحة ملاحظات واحدة. يحتوي شكل العنصر النائب الأول BODY في صفحة الملاحظات الخاصة بشريحة ما على نص ملاحظات المتحدث الخاصة بالشريحة. يمكن تعديل المحتوى النصي لشكل الملاحظات هذا فقط في Slides API. تكون خصائصه الأخرى وبقية محتوى صفحة الملاحظات للقراءة فقط.
صفحة العرض التقديمي الرئيسية للملاحظات هي صفحة تحدد العناصر التلقائية وأنماط النصوص المستخدَمة في صفحات الملاحظات. لا يتضمّن العرض التقديمي سوى شريحة رئيسية واحدة للملاحظات. تكون الشرائح الرئيسية للقراءة فقط في Slides API.
قراءة ملاحظات المحاضر وكتابتها
للعثور على شكل ملاحظات المحاضر في شريحة، ابحث عن عنصر ملاحظات الشريحة
presentations.pages
في رسالة
SlideProperties. يتم تحديد الشكل الذي يحتوي على نص ملاحظات المتحدث من خلال الحقل speakerNotesObjectId في رسالة NotesProperties الخاصة بصفحة الملاحظات.
لقراءة ملاحظات المتحدث الخاصة بشريحة، ابحث عن عنصر يحمل رقم التعريف هذا في صفحة الملاحظات واقرأ النص الخاص به. في حالات نادرة، قد لا يكون هذا العنصر متوفّرًا، ما يعني أنّ الشرائح لا تتضمّن ملاحظات المحاضر.
يمكنك استخدام طلبات نصية batchUpdate لتعديل النص داخل شكل ملاحظات المتحدث. في الحالات النادرة التي لا يتوفّر فيها شكل ملاحظات المتحدث، تنشئه واجهة برمجة التطبيقات Slides API تلقائيًا عندما تتلقّى عملية نصية صالحة باستخدام speakerNotesObjectId.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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`."]]
