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