تتيح لك Google Slides API إنشاء عروض تقديمية على Google Slides وتعديلها.
يمكن للتطبيقات الدمج مع Google Slides API لإنشاء عروض تقديمية جميلة تلقائيًا من البيانات المقدَّمة من المستخدم والنظام. على سبيل المثال، يمكنك استخدام تفاصيل العملاء من قاعدة بيانات ودمجها مع نماذج مُصمّمة مسبقًا وخيارات ضبط محدّدة لإنشاء عروض تقديمية مكتملة في جزء من الوقت الذي يستغرقه إنشاؤها يدويًا.
نظرة عامة على واجهة برمجة التطبيقات
توفّر مجموعة العروض التقديمية methods التي تتيح لك الحصول على العناصر وتعديلها في العرض التقديمي.
سيتمحور معظم عملك باستخدام Slides API على إنشاء العروض التقديمية وتعديلها. يمكنك إجراء ذلك باستخدام الطريقة batchUpdate، وهذه الطريقة تأخذ قائمة بعناصر Request التي تتيح لك تنفيذ إجراءات مثل:
- إنشاء شرائح
- إضافة عناصر إلى الشرائح، مثل الأشكال أو الجداول
- إدراج نص وتغييره وإزالته
- تطبيق عمليات التحويل على العناصر
- تغيير ترتيب الشرائح
يمكنك الاطّلاع على تعديلات الدُفعات لمزيد من التفاصيل. اطّلِع على أدلة "البدء" للاطّلاع على مثال بسيط شامل حول كيفية استخدام واجهة برمجة التطبيقات.
بنية العرض التقديمي
يتألّف العرض التقديمي في Slides API من صفحات تحتوي على عناصر الصفحات.
يمكن الحصول على معرّف العرض التقديمي من عنوان URL:
https://docs.google.com/presentation/d/presentationId/edit
معرّف العرض التقديمي هو سلسلة تحتوي على أحرف وأرقام وبعض الأحرف الخاصة. يمكن استخدام التعبير العادي التالي لاستخراج معرّف العرض من عنوان URL في "جداول بيانات Google":
/presentation/d/([a-zA-Z0-9-_]+)
إذا كنت على دراية بواجهة برمجة التطبيقات Drive API، يتوافق العنصر presentationId مع
رقم تعريف مورد الملف.
يتم تحديد الصفحات وعناصر الصفحة من خلال أرقام تعريف الكائنات.
Pages
تتضمّن "العروض التقديمية من Google" الأنواع التالية من الصفحات:
| الماجستير | تحدِّد الشرائح الرئيسية أنماط النص التلقائية والخلفية وعناصر الصفحة التي تظهر في جميع الشرائح التي تستخدِم هذه الشريحة الرئيسية. يجب إضافة عناصر الصفحة التي يجب أن تظهر في جميع الشرائح إلى الشريحة الرئيسية. تحتوي معظم العروض التقديمية على عرض رئيسي واحد، ولكن قد تحتوي بعض العروض على عدة عروض رئيسية أو لا تحتوي على أي عرض رئيسي. |
| التنسيقات | تُستخدَم التنسيقات كنموذج لكيفية ترتيب عناصر الصفحة تلقائيًا على الشرائح باستخدام تنسيق. يرتبط كل تنسيق بأحد التنسيقات الرئيسية. |
| شرائح | تحتوي هذه الصفحات على المحتوى الذي تقدّمه لجمهورك. تستند معظم الشرائح إلى نموذج أساسي وتنسيق. يمكنك تحديد التنسيق الذي تريد استخدامه لكل شريحة عند إنشائها. |
| ملاحظات | تحتوي هذه الصفحات على محتوى النشرات المخصّصة للعروض التقديمية، بما في ذلك شكل يحتوي على ملاحظات المتحدّث الخاصة بالشريحة. تحتوي كل شريحة على صفحة ملاحظات مقابلة. لا يمكن تعديل سوى النص في شكل ملاحظات المحاضر باستخدام Slides API. |
| ملاحظات رئيسية | تحدّد نماذج الملاحظات أنماط النصوص وعناصر الصفحة التلقائية لجميع الصفحات في الملاحظات. تكون نماذج الملاحظات للقراءة فقط في واجهة برمجة التطبيقات Slides API. |
عناصر الصفحة
عناصر الصفحة هي المكونات المرئية التي يتم وضعها على الصفحات. تعرِض واجهة برمجة التطبيقات عدة أنواع من عناصر الصفحة:
| مجموعة | مجموعة من عناصر الصفحة التي يتم التعامل معها كوحدة فردية ويمكن نقلها وتغيير حجمها وتدويرها معًا. |
| شكل | كائن مرئي عادي، مثل المستطيلات وعلامات الحذف ومربعات النص يمكن أن تحتوي الأشكال على نص، لذا فهي أكثر عناصر الصفحة شيوعًا لإنشاء الشرائح. |
| صورة | رسم مستورَد إلى "العروض التقديمية من Google" |
| فيديو | فيديو تم استيراده إلى "العروض التقديمية من Google" |
| سطر | خط أو منحنى أو وصلة مرئية |
| جدول | شبكة من المحتوى |
| WordArt | عنصر نص مرئي يتصرف بشكل أشبه بالشكل. |
| SheetsChart | رسم بياني تم استيراده إلى "العروض التقديمية من Google" من "جداول بيانات Google" |
التحديثات المجمّعة
تتيح لك الطريقة batchUpdate تعديل العديد من جوانب العرض التقديمي. يتم تجميع التغييرات معًا في مجموعة حتى إذا تعذّر إكمال طلب واحد، لا يتم كتابة أي من التغييرات (التي قد تكون متعلّقة) الأخرى.
تعمل طريقة batchUpdate من خلال أخذ عنصر واحد أو أكثر من نوع
Request
، يحدِّد كلٌّ منها نوعًا واحدًا من الطلبات المطلوب تنفيذها. هناك
العديد من الأنواع المختلفة من الطلبات. في ما يلي تصنيف لأنواع الطلبات،
المجمّعة في فئات مختلفة.
تُعرِض الطريقة batchUpdate نص الاستجابة،
الذي يحتوي على
استجابة
لكل طلب. يحتلّ كلّ استجابة الفهرس نفسه للطلب المرتبط به، وبالنسبة إلى الطلبات التي لا تتضمّن استجابة سارية، ستكون الاستجابة في ذلك الفهرس فارغة. عادةً ما تتضمّن طلبات Create المختلفة استجابات، وبالتالي
يمكنك معرفة معرّف العنصر الذي تمت إضافته حديثًا.
العمل مع معرّفات الصور
يتألّف العرض التقديمي في Slides API من الصفحات وعناصر الصفحة. تتضمّن هذه العناصر سلسلة رقم تعريف العنصر الفريدة ضمن العرض التقديمي.
تحديد معرّفات العناصر عند الإنشاء
عند إنشاء صفحات أو عناصر صفحات باستخدام الأسلوب batchUpdate، يمكنك اختياريًا تحديد معرّف كائن للكائن الجديد. يتيح لك ذلك إنشاء عنصر وتعديله ضمن طلب batchUpdate نفسه، ما يقلل من عدد طلبات البيانات إلى واجهة برمجة التطبيقات Slides API ويقلّل من استخدام الحصة.
ننصحك بإنشاء معرّف عشوائي للجسم في معظم الحالات. على سبيل المثال، إذا كنت
تستخدم Java، من المفترض أن يعمل java.util.UUID.randomUUID().toString() بشكل جيد.
عندما يريد تطبيقك تتبُّع الأجسام على مدار فترة زمنية أطول، لا تعتمد على معرّف الجسم، لأنّه قد يتغيّر. يُرجى الاطّلاع على القسم التالي لمزيد من التفاصيل.
تتبُّع الأجسام بدون استخدام رقم تعريفها
عند إرسال طلب إلى واجهة برمجة التطبيقات Slides API، يتم عادةً الاحتفاظ بمعرّف العنصر. (يتم الإشارة إلى أي استثناءات في مستندات مرجع الطريقة). يؤدي إنشاء نسخة من عرض تقديمي كامل باستخدام واجهة برمجة التطبيقات Drive API إلى الاحتفاظ بمعرّفات العناصر أيضًا.
ومع ذلك، لا يمكنك الاعتماد على عدم تغيير معرّف عنصر بعد تغيير عرض تقديمي في واجهة مستخدم "العروض التقديمية من Google". على سبيل المثال، إذا استخدم أحد الأشخاص واجهة مستخدم Slides لنسخ عنصر صفحة ولصقه ثم حذف العنصر الأصلي، سيحصل عنصر الصفحة على معرّف فريد جديد، وسيتم فقدان المعرّف الذي قدّمته سابقًا من خلال واجهة برمجة التطبيقات. ونتيجةً لذلك، لا ننصح بتخزين أرقام تعريف العناصر في ملف التخزين في تطبيقك. بدلاً من ذلك، يجب العثور على الكائنات في العرض التقديمي باستخدام محتوى النص أو النص البديل.
تستخدم العروض التقديمية المنشأة حديثًا عادةً مجموعة متسقة من المعرّفات لملفّات الشرائح الرئيسية والمربّعات النصية التلقائية. تخضع هذه الأرقام التعريفية للتغيير بمرور الوقت، لذلك لا ننصح بالاعتماد على هذه الميزة. بدلاً من ذلك، ابحث عن العناصر التي تريد تعديلها باستخدام عنصر العرض الذي تعرضه طلبات create() أو get().