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

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

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

• إنشاء العروض التقديمية وإدارتها
• البحث عن الملفات والمجلدات
• دمج البيانات في عرض تقديمي

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

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

من الممكن أيضًا إنشاء ملفات عروض تقديمية فارغة باستخدام طريقة 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 type.

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

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."
      }
    }
  ]
}