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

يمكن لـ 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();
  // Get the object ID of the first slide in the presentation
  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()}`;

  // The thumbnail image URL is in the response
  const request = UrlFetchApp.fetch(apiUrlWithToken);
  const { contentUrl } = JSON.parse(request.getContentText());

  // The thumbnail image width of 1600px.
  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