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

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

يتم تقديم هذه الأمثلة كطلبات HTTP لتكون محايدة لغويًا. للتعرّف على كيفية تنفيذ تعديل مجمّع بلغات مختلفة باستخدام مكتبات برامج Google API، راجِع الأدلة التالية:

إنشاء عرض تقديمي

يوضّح نموذج الرمز التالي كيفية إنشاء ملف عرض تقديمي فارغ بعنوان "عرضي التقديمي الجديد".presentations.create

يمكن أيضًا إنشاء ملفات عروض تقديمية فارغة باستخدام طريقة files.create في Google Drive API من خلال تحديد application/vnd.google-apps.presentation كـ نوع MIME.

في ما يلي بروتوكول الطلب لإنشاء عرض تقديمي:

POST https://slides.googleapis.com/v1/presentations
 
{
  "title": "My New Presentation"
}

عرض قائمة بملفات العروض التقديمية الحالية

لا توفّر Slides API طريقة لاسترداد قائمة بالعروض التقديمية، ولكن توفّرها 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." بالنص "Gadget Inc." ويشمل ذلك النص في مربعات النص والأشكال الأخرى وعلى الشرائح وداخل الشرائح الرئيسية. في هذه الحالة، يكون استبدال النص حسّاسًا لحالة الأحرف من خلال ضبط matchCase على true.

في ما يلي بروتوكول الطلب لاستبدال النص في جميع أنحاء العرض التقديمي:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
 
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}