استخدام ملاحظات المحاضر

يوضّح هذا الدليل كيفية قراءة ملاحظات المحاضر وتعديلها باستخدام Google Slides API.

صفحات الملاحظات والصفحات الرئيسية للملاحظات

صفحة الملاحظات هي نوع من الصفحات يُستخدَم لإنشاء نُسخ مطبوعة للشرائح في عرض تقديمي. تحتوي كل شريحة على صفحة ملاحظات واحدة. يحتوي شكل العنصر النائب الأول BODY في صفحة الملاحظات الخاصة بشريحة ما على نص ملاحظات المتحدث الخاصة بالشريحة. يمكن تعديل المحتوى النصي لشكل الملاحظات هذا فقط في Slides API. تكون خصائصه الأخرى وبقية محتوى صفحة الملاحظات للقراءة فقط.

صفحة العرض التقديمي الرئيسية للملاحظات هي صفحة تحدد العناصر التلقائية وأنماط النصوص المستخدَمة في صفحات الملاحظات. لا يتضمّن العرض التقديمي سوى شريحة رئيسية واحدة للملاحظات. تكون الشرائح الرئيسية للقراءة فقط في Slides API.

قراءة ملاحظات المحاضر وكتابتها

للعثور على شكل ملاحظات المحاضر في شريحة، ابحث عن عنصر ملاحظات الشريحة presentations.pages في رسالة SlideProperties. يتم تحديد الشكل الذي يحتوي على نص ملاحظات المتحدث من خلال الحقل speakerNotesObjectId في رسالة NotesProperties الخاصة بصفحة الملاحظات.

لقراءة ملاحظات المتحدث الخاصة بشريحة، ابحث عن عنصر يحمل رقم التعريف هذا في صفحة الملاحظات واقرأ النص الخاص به. في حالات نادرة، قد لا يكون هذا العنصر متوفّرًا، ما يعني أنّ الشرائح لا تتضمّن ملاحظات المحاضر.

يمكنك استخدام طلبات نصية batchUpdate لتعديل النص داخل شكل ملاحظات المتحدث. في الحالات النادرة التي لا يتوفّر فيها شكل ملاحظات المتحدث، تنشئه واجهة برمجة التطبيقات Slides API تلقائيًا عندما تتلقّى عملية نصية صالحة باستخدام speakerNotesObjectId.