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