مقدمة

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

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

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

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

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

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

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

بنية العرض التقديمي

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

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

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

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

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

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

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

الصفحات

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

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

عناصر الصفحة

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

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

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

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

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

التعامل مع العروض التقديمية: إنشاء شريحة طلب
تعديل عروض تقديمية من Google في موضع محدّد
duplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
التعامل مع عناصر الصفحة: إنشاء شكل طلب
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
duplicateObjectRequest
DeleteObjectRequest
التعامل مع الجداول: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
التعامل مع المخططات: CreateSheetsChartRequest
refreshSheetsChartRequest
استبدال كل الأشكال بجداول البيانات في الرسم البياني
DeleteObjectRequest
التعامل مع الصور والفيديو: إنشاء صورة طلب
إنشاء فيديو طلب
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
استبدال جميع الأشكال بـ ImageRequest
duplicateObjectRequest
DeleteObjectRequest
التعامل مع النصوص: InsertTextRequest
DeleteTextRequest
استبدال الكل نص
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

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

التعامل مع أرقام تعريف العناصر

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

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

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