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

تتيح لك Google Slides API إنشاء ملفات العروض التقديمية وإدارة الملفات الحالية. توضّح الأمثلة في هذه الصفحة بعض العمليات الشائعة لعرض الصفحات باستخدام الطريقة 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 API طريقة. تستخدم طريقة 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."
      }
    }
  ]
}