كيفية تحويل شرائح Google إلى صور PNG باستخدام Google Script

تعرف على كيفية تحويل شرائح Google إلى صور PNG عالية الدقة باستخدام Google Apps Script. اختر بين Google Slides API وGoogle Drive API بناءً على متطلباتك.

يمكن لـ Document Studio تحويل شرائح Google إلى صور PNG عالية الدقة. يمكن أن يكون هذا مفيدًا إذا كنت تريد إنشاء أشكال متعددة لنفس الشريحة بشكل مجمّع – أنشئ قالبًا واحدًا في شرائح Google ثم استخدم Document Studio لإنشاء صور PNG بنصوص أو صور مختلفة، مأخوذة من ورقة Google أو نماذج Google.

داخليًا، يستخدم التطبيق Google APIs لإنشاء صور مصغرة عالية الدقة للشرائح وتحميل الشرائح الفردية إلى Google Drive للمستخدم الحالي.

في هذا البرنامج التعليمي، سوف نستكشف طريقتين لتحقيق التحويل من الشريحة إلى png باستخدام Google Apps Script.

النهج رقم 1 – استخدم Google Slides API

يمكنك استخدام Google Slides API للحصول على الصور المصغرة للشرائح، وجلب النقطة الكبيرة من الصورة، ثم تحميل الصورة إلى Google Drive.

const generateSlideScreenshot = () => {
  const presentation = SlidesApp.getActivePresentation();
  const presentationId = presentation.getId();
  
  const pageObjectId = presentation.getSlides()[0].getObjectId();
  const apiUrl = `https://slides.googleapis.com/v1/presentations/${presentationId}/pages/${pageObjectId}/thumbnail`;
  const apiUrlWithToken = `${apiUrl}?access_token=${ScriptApp.getOAuthToken()}`;

  
  const request = UrlFetchApp.fetch(apiUrlWithToken);
  const { contentUrl } = JSON.parse(request.getContentText());

  
  const blob = UrlFetchApp.fetch(contentUrl).getBlob();
  DriveApp.createFile(blob).setName('image.png');
};

محددات

هناك بعض القيود مع النهج السابق.

أولاً، ستحتاج إلى تمكين Google Slides API في وحدة التحكم الخاصة بمشروع Google Cloud المرتبط بمشروع Google Apps Script. ثانيًا، الصور المصغرة لها عرض ثابت يبلغ 1600 بكسل/800 بكسل/200 بكسل ولا يمكنك تغيير حجم الصورة.

تحتاج أيضًا إلى إجراء استدعاءين لواجهة برمجة التطبيقات (API) هنا. الأول هو الحصول على الرابط المصغر للعرض التقديمي. سيؤدي استدعاء API الإضافي إلى جلب الصورة المصغرة من عنوان URL.

النهج رقم 2 – استخدم Google Drive API

الطريقة الموصى بها هي استخدام Google Drive API لتصدير الشرائح كصور PNG. الميزة الكبيرة هنا هي أن الصورة التي تم إنشاؤها لها نفس دقة الشريحة الأصلية. لذا، إذا قمت بتعيين حجم صفحة العرض التقديمي الخاص بك على 600 × 800 بكسل، فستكون صورة PNG التي تم إنشاؤها بنفس الحجم أيضًا.

وهناك استدعاء أقل لواجهة برمجة التطبيقات (API) حيث يمكن لـ Drive API تصدير الشريحة مباشرة كصورة.

const generateSlideScreenshotWithDrive = () => {
  const presentation = SlidesApp.getActivePresentation();
  const id = presentation.getId();
  const pageid = presentation.getSlides()[0].getObjectId();

  const apiUrl = `https://docs.google.com/presentation/d/${id}/export/png?id=${id}&pageid=${pageid}`;
  const parameters = {
    method: 'GET',
    headers: { Authorization: `Bearer ${ScriptApp.getOAuthToken()}` },
    contentType: 'application/json',
  };

  const request = UrlFetchApp.fetch(apiUrl, parameters);
  const blob = request.getBlob();
  DriveApp.createFile(blob).setName('image.png');
};

راجع أيضًا: تحويل مستندات وجداول بيانات Google