يوضّح هذا الدليل كيفية قراءة ملاحظات المحاضر وتعديلها باستخدام Google Slides API.
صفحات الملاحظات وملاحظات رئيسية
صفحة الملاحظات هي نوع من الصفحات المستخدَمة لإنشاء ملفات معلومات للشرائح في أحد
العروض التقديمية. تحتوي كل شريحة على صفحة ملاحظات واحدة. يحتوي الشكل النائب BODY الأول
في صفحة ملاحظات الشريحة على نص ملاحظات المتحدّث الخاصة بشريحة. لا يمكن تعديل سوى
محتوى النص في شكل الملاحظات هذا في Slides API. إنّ ملف السجلّ هو للقراءة فقط، ويكون باقي ملف السجلّ وملف الملاحظات للقراءة فقط.
الصفحة الرئيسية للملاحظات في العرض التقديمي هي صفحة تحدِّد العناصر التلقائية و styles النص المستخدَمة في صفحات الملاحظات. يحتوي العرض التقديمي على ملاحظات رئيسية واحدة فقط. تكون نماذج ملاحظات للقراءة فقط في واجهة برمجة التطبيقات Slides API.
قراءة ملاحظات المحاضر وكتابتها
للعثور على شكل ملاحظات المحاضر في إحدى الشرائح، ابحث عن رمز ملاحظات الشريحة
presentations.pages
في رسالته
SlideProperties. يتم تحديد الشكل الذي يحتوي على نص ملاحظات المتحدّث من خلال الحقل
speakerNotesObjectId في رسالة
NotesProperties
صفحة الملاحظات.
لقراءة ملاحظات المتحدّث في إحدى الشرائح، ابحث عن عنصر يحمل هذا المعرّف في صفحة الملاحظات واقرأ نصّه. في حالات نادرة، قد لا يكون هذا العنصر متوفّرًا، ما يعني أنّ العروض التقديمية لا تحتوي على ملاحظات المحاضر.
يمكنك استخدام طلبات النصوص batchUpdate
لتعديل النص داخل شكل ملاحظات المتحدّث. في الحالة النادرة التي لا يتوفّر فيها شكل ملاحظات المتحدّث، تنشئ Slides API هذا الشكل
تلقائيًا عند تلقّي عملية نص صالحة باستخدام
speakerNotesObjectId.