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

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

تستخدم هذه الأمثلة المتغيرات التالية:

• presentationId — تشير إلى مكان تقديم معرّف العرض التقديمي. يمكنك اكتشاف قيمة رقم التعريف هذا من عنوان URL للعرض التقديمي.
• pageId — تشير إلى المكان الذي تقدم فيه رقم تعريف كائن الصفحة. يمكنك استرداد قيمة هذا من عنوان URL أو باستخدام طلب قراءة لواجهة برمجة التطبيقات.
• pageElementId — تشير إلى المكان الذي تقدم فيه رقم تعريف كائن عنصر الصفحة. يمكنك تحديد هذا المعرّف للعناصر التي تنشئها (مع فرض بعض القيود) أو السماح لـ API بإنشاء عنصر تلقائيًا، ويمكن استرداد معرّفات العناصر من خلال طلب قراءة واجهة برمجة التطبيقات.

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

يؤدي طلب presentations.create التالي إلى إنشاء ملف عرض تقديمي جديد فارغ باسم "عرضي التقديمي الجديد". من الممكن أيضًا إنشاء ملفات عروض تقديمية فارغة باستخدام طريقة Google Drive API Files.create، من خلال تحديد application/vnd.google-apps.presentation على أنه mimeType.

يظهر بروتوكول الطلب أدناه. يوضح دليل إنشاء العروض التقديمية وإدارتها مثالاً ينفذ تحديثًا مجمعًا بلغات مختلفة باستخدام مكتبات برامج Google API.

POST https://slides.googleapis.com/v1/presentations

{
  "title": "My New Presentation"
}

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

لا توفر واجهة برمجة التطبيقات للعروض التقديمية طريقة لاسترداد قائمة العروض التقديمية، ولكن يمكن تنفيذ ذلك بسهولة باستخدام واجهة برمجة تطبيقات Drive. يستخدم طلب Drive API Files.list الذي تم تقديمه هنا الأقنعة الميدانية لعرض قائمة بملفات العرض التقديمي في Drive، مع معرّفات الملفات وعناوينها ورابط.

يظهر بروتوكول الطلب أدناه. يعرض دليل البحث عن ملفات في Drive مثالاً ينفذ طلب بحث في ملف بلغات مختلفة باستخدام مكتبات برامج Google API.

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

يظهر بروتوكول الطلب أدناه. يعرض دليل دمج البيانات في العروض التقديمية مثالاً ينفذ تحديثًا مجمعًا بلغات مختلفة باستخدام مكتبات برامج Google API.

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate

{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}