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

تتيح لك 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"
}

إدراج ملفات العروض التقديمية الحالية

لا توفّر واجهة برمجة التطبيقات 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."
      }
    }
  ]
}