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

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

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

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

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

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

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

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

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