تتيح لك واجهة برمجة تطبيقات العروض التقديمية من Google إنشاء ملفات العروض التقديمية وإدارة الملفات الحالية.
تعرض الأمثلة في هذه الصفحة بعض العمليات الشائعة لعرض الصفحات باستخدام طريقة presentations.batchUpdate
.
ويتم تقديم هذه الأمثلة على شكل طلبات HTTP لكي تكون محايدة لغوية. للاطّلاع على كيفية تنفيذ تحديث مجمّع بلغات مختلفة باستخدام مكتبات برامج واجهة Google API، يُرجى الاطّلاع على الأدلة التالية:
إنشاء عرض تقديمي
يوضح الرمز البرمجي
presentations.create
التالي كيفية إنشاء ملف عرض تقديمي فارغ بعنوان "عرضي التقديمي الجديد".
من الممكن أيضًا إنشاء ملفات عروض تقديمية فارغة باستخدام طريقة Google Drive API
files.create
من خلال تحديد
application/vnd.google-apps.presentation
على أنّه نوع
MIME.
فيما يلي بروتوكول الطلب لإنشاء عرض تقديمي:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
سرد ملفات العرض التقديمي الحالية
لا توفر واجهة برمجة تطبيقات العروض التقديمية طريقة لاسترداد قائمة العروض التقديمية، بينما توفر واجهة برمجة تطبيقات Drive ذلك.
تستخدم الطريقة files.list
(الواردة أدناه) أقنعة الحقول لعرض قائمة
بملفات العرض التقديمي من Drive، مع معرّف الملف واسم الملف
ورابط لفتح الملف. يحدد الطلب أيضًا application/vnd.google-apps.presentation
على أنه نوع MIME.
في ما يلي بروتوكول الطلب لسرد ملفات العرض التقديمي الحالية:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
يحتوي الرد على هذا الطلب على البنية التالية:
{ "files": [ { "id": "abcdefghijklmnopqrstuvwxyz0123456789", "name": "Project Vision", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk" }, { "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "name": "Untitled Presentation", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk" }, ... ] }
استبدال النص خلال عرض تقديمي
يوضّح الرمز البرمجي
presentations.batchUpdate
التالي كيفية استخدام طريقة
ReplaceAllTextRequest
لاستبدال النص خلال العرض التقديمي المحدَّد في
PRESENTATION_ID. يمكنك اكتشاف قيمة
رقم تعريف العرض التقديمي
من عنوان URL للعرض التقديمي.
يتم استبدال كل مثيل من السلسلة "Gizmo Corp." بالنص "Widget
Inc". يتضمن ذلك النص في مربعات النص والأشكال الأخرى وعلى الشرائح وفي الشرائح الرئيسية. في هذه الحالة، يكون استبدال النص حسّاسًا لحالة الأحرف من خلال ضبط matchCase
على true
.
في ما يلي بروتوكول الطلب لاستبدال النص خلال العرض التقديمي:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }