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

تتيح لك 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." بالنص "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."
      }
    }
  ]
}