تتيح لك 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
مع رقم تعريف مورد
File.
يتم تحديد الصفحات وعناصر الصفحة من خلال أرقام تعريف الكائنات.
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().