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

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

صفحات الملاحظات وملاحظات الأركان الأساسية

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

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

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

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

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

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