مقدمة

تتيح لك Google Slides API إنشاء عروض تقديمية في "العروض التقديمية من Google" وتعديلها.

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

نظرة عامة على واجهة برمجة التطبيقات

توفّر مجموعة العروض التقديمية التي تتيح لك الحصول على العناصر وتحديثها داخل العرض التقديمي.

من المحتمل أن يتم إنشاء وتحديث معظم أعمالك باستخدام واجهة برمجة تطبيقات "العروض التقديمية من Google". وعروضك التقديمية. ستقوم بذلك باستخدام batchUpdate؛ تأخذ هذه الطريقة قائمة طلب كائنات تتيح لك تنفيذ إجراءات مثل:

  • إنشاء شرائح
  • إضافة عناصر إلى الشرائح مثل الأشكال أو الجداول
  • إدراج النص وتغييره وإزالته
  • تطبيق التحويلات على العناصر
  • تغيير ترتيب الشرائح

راجِع التحديثات المجمّعة لمعرفة مزيد من التفاصيل. الاطّلاع على أدلة البدء للحصول على مثال بسيط وشامل عن كيفية استخدام واجهة برمجة التطبيقات

هيكل العرض التقديمي

يتكون العرض التقديمي في واجهة برمجة تطبيقات الشرائح من صفحات تحتوي على صفحة عناصر.

يمكن اشتقاق معرّف العرض التقديمي من عنوان URL:

https://docs.google.com/presentation/d/presentationId/edit

معرف العرض التقديمي هو سلسلة تحتوي على أحرف وأرقام وبعض العناصر الخاصة الأحرف. يمكن استخدام التعبير العادي التالي لاستخراج معرّف العرض التقديمي من عنوان URL لـ "جداول بيانات Google":

/presentation/d/([a-zA-Z0-9-_]+)

إذا كنت على دراية بواجهة برمجة تطبيقات Drive، يتوافق presentationId مع رقم تعريف الملف المصدر.

يتم تحديد الصفحات وعناصر الصفحة من خلال أرقام تعريف الكائنات.

Pages

تشتمل "العروض التقديمية من Google" على الأنواع التالية من الصفحات:

الماجستير تحدد الشرائح الرئيسية للشريحة أنماط النص والخلفية والصفحة الافتراضية العناصر التي تظهر في كافة الشرائح التي تستخدم هذه الشريحة الرئيسية. صفحة يجب إضافة العناصر التي يجب أن تظهر في كافة الشرائح إلى الشرائح الرئيسية. معظم الأقسام والعروض التقديمية تحتوي على درجة رئيسية واحدة، ولكن قد يحتوي بعضها على عدة صفحات رئيسية أو لا شيء على الإطلاق.
التنسيقات تعمل التخطيطات كقالب لكيفية ترتيب عناصر الصفحة من خلال افتراضيًا على الشرائح باستخدام تخطيط. يرتبط كل تخطيط بواحد رئيسي.
شرائح تتضمن هذه الصفحات المحتوى الذي تقدمه لجمهورك. تستند معظم الشرائح إلى شريحة رئيسية وتخطيط. يمكنك تحديد بشكل صحيح لاستخدامه مع كل شريحة عند إنشائها.
ملاحظات تحتوي هذه الصفحات على محتوى نشرات العرض التقديمي، بما في ذلك شكل يحتوي على ملاحظات المتحدث في الشريحة. تحتوي كل شريحة على واحدة صفحة الملاحظات المقابلة. لا يمكن إضافة سوى النص في شكل "ملاحظات المحاضر" تم تعديله باستخدام واجهة برمجة تطبيقات الشرائح.
جهات الاتصال الرئيسية للملاحظات تُحدِّد المجموعات الرئيسية في Notes أنماط النص التلقائية وعناصر الصفحة للجميع صفحات الملاحظات. تكون الشرائح الرئيسية للملاحظات للقراءة فقط في واجهة برمجة تطبيقات "العروض التقديمية من Google".

عناصر الصفحة

عناصر الصفحة هي المكونات المرئية التي يتم وضعها على الصفحات. واجهة برمجة التطبيقات تعرض أنواعًا عديدة من عناصر الصفحة:

مجموعة مجموعة من عناصر الصفحة يتم التعامل معها كوحدة فردية. يمكنه تحريكها وقياسها وتدويرها معًا.
شكل كائن مرئي عادي، مثل المستطيلات والقطع الناقص ومربعات النص. يمكن أن تحتوي الأشكال على نص، لذا فهي عناصر الصفحة الأكثر شيوعًا لإنشاء شرائح.
صورة رسم تم استيراده إلى "العروض التقديمية من Google".
فيديو تم استيراد فيديو إلى "العروض التقديمية من Google".
سطر خط مرئي أو منحنى أو موصِّل.
جدول شبكة من المحتوى
WordArt يشير ذلك المصطلح إلى عنصر نص مرئي يشبه الشكل.
SheetsChart تم استيراد رسم بياني إلى "العروض التقديمية من Google" من "جداول بيانات Google".

التحديثات المجمّعة

طريقة batchUpdate تحديث العديد من جوانب العرض التقديمي. يتم تجميع التغييرات معًا في دفعة بحيث إذا فشل أحد الطلبات، لا شيء آخر (يُحتمل أن يكون معتمدًا) كتابة التغييرات.

تعمل طريقة batchUpdate من خلال استخدام طريقة واحدة أو أكثر طلب كل كائن يحدد نوعًا واحدًا من الطلب لتنفيذه. تتوفر والعديد من أنواع الطلبات المختلفة. إليك تصنيفًا لأنواع الطلبات مجمعة في فئات مختلفة.

التعامل مع العروض التقديمية: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
التعامل مع عناصر الصفحة: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
التعامل مع الجداول: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
التعامل مع المخططات: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
التعامل مع الصور والفيديوهات: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
التعامل مع النصوص: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

تعرض الطريقة batchUpdate نص استجابة، والذي يحتوي على الرد لكل طلب. تشغَل كل استجابة الفهرس نفسه مثل الفهرس request; بالنسبة إلى الطلبات التي لا تتضمّن أي استجابة سارية، يكون الردّ في هذا الفهرس ستكون فارغة. عادةً ما يكون لطلبات Create المختلفة ردودًا، لذا أنك تعرف معرف الكائن المُضافة حديثًا.

التعامل مع معرّفات الكائنات

يتكون العرض التقديمي في واجهة برمجة التطبيقات للعروض التقديمية من صفحات وعناصر صفحة. وتتضمّن هذه الكائنات سلسلة معرّف كائن فريدة داخل عرضنا التقديمي.

تحديد أرقام تعريف العناصر عند الإنشاء

عند إنشاء صفحات أو عناصر صفحة باستخدام batchUpdate، حيث يمكنك اختياريًا تحديد رقم تعريف كائن للكائن الجديد. يتيح لك هذا إنشاء وتعديله ضمن طلب التحديث المجمّع نفسه، ما يؤدي إلى تقليل عدد طلبات البيانات إلى واجهة برمجة تطبيقات "العروض التقديمية من Google" وتقليل استخدام الحصص.

وننصح بإنشاء رقم تعريف كائن عشوائي في معظم الحالات. على سبيل المثال، إذا تستخدم Java، من المفترض أن يعمل java.util.UUID.randomUUID().toString() بشكل جيد.

عندما يريد تطبيقك تتبع الكائنات على مدار فترة أطول من الوقت، لا تعتمد على معرف الكائن، لأنه قد يتغير. يمكنك الاطّلاع على ما يلي: لمزيد من التفاصيل.

تتبُّع العناصر بدون استخدام رقم تعريف الكائن

عند تقديم طلب من Google Slides API، يتم عادةً الاحتفاظ برقم تعريف العنصر. (أي يتم استدعاء الاستثناءات في المستندات المرجعية للطريقة). سيكون إنشاء نسخة من عرض تقديمي كامل باستخدام Drive API تحتفظ أيضًا بمعرّفات الكائنات.

ومع ذلك، لا يمكنك الاعتماد على عدم تغيير رقم تعريف الكائن بعد العرض التقديمي. في واجهة مستخدم العروض التقديمية. فعلى سبيل المثال، إذا كان شخص ما يستخدم تطبيق العروض التقديمية واجهة مستخدم لنسخ ولصق عنصر صفحة ثم حذف العنصر الأصلي، وهو عنصر الصفحة سيكون له معرّف فريد جديد ورقم التعريف الذي قدّمته سابقًا عبر واجهة برمجة التطبيقات فستفقدها. ونتيجةً لذلك، ننصحك بعدم تخزين معرّفات العناصر في مساحة تخزين التطبيق. بدلاً من ذلك، يجب عليك العثور على كائنات في العرض التقديمي عن طريق محتواه النصي أو النص البديل.

تستخدم العروض التقديمية المنشأة حديثًا عادةً مجموعة متسقة من المعرّفات كإعداد تلقائي والشرائح الرئيسية والشرائح ومربعات النص. تخضع أرقام التعريف هذه للتغيير بمرور الوقت، لذلك لا ننصح بالاعتماد على هذه الميزة بدلاً من ذلك، ابحث عن العناصر تريد التعديل باستخدام كائن العرض التقديمي الذي يتم عرضه بواسطة عمليات استدعاء create() أو get().