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

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