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

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

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

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

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

من الممكن أيضًا إنشاء ملفات عروض تقديمية فارغة باستخدام 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. " يتم استبداله بالنص "الأدوات" Inc. " يتضمن ذلك النص في مربعات النص والأشكال الأخرى، وعلى الشرائح، وضمن ماجستير. في هذه الحالة، يكون استبدال النص حساسًا لحالة الأحرف من خلال تعيين matchCase إلى true.

فيما يلي بروتوكول الطلب لاستبدال النص خلال العرض التقديمي:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}