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

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

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

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

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

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

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

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

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