Google Apps Script: Как вставить изображение из Google Диска?

// Пример манифеста appsscript.json (обычно генерируется автоматически)
{
  "timeZone": "Europe/Moscow",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.container.ui",
    "https://www.googleapis.com/auth/documents",
    "https://www.googleapis.com/auth/drive.readonly", // Достаточно для чтения файла
    "https://www.googleapis.com/auth/spreadsheets",
    "https://www.googleapis.com/auth/presentations"
  ]
}

/**
 * Получает объект файла изображения с Google Диска по его ID.
 * @param {string} imageId Уникальный идентификатор файла изображения.
 * @returns {GoogleAppsScript.Drive.File | null} Объект файла или null, если файл не найден.
 */
function getImageFileFromDrive_(imageId: string): GoogleAppsScript.Drive.File | null {
  try {
    const file = DriveApp.getFileById(imageId);
    return file;
  } catch (e) {
    console.error('Ошибка получения файла %s: %s', imageId, e);
    return null;
  }
}

/**
 * Вставляет изображение из Google Диска в активный Google Документ.
 * @param {string} imageId ID файла изображения на Google Диске.
 */
function insertImageIntoDoc(imageId: string): void {
  const doc = DocumentApp.getActiveDocument();
  const body = doc.getBody();

  const imageFile = getImageFileFromDrive_(imageId);

  if (imageFile) {
    try {
      const imageBlob = imageFile.getBlob();
      // Вставляем изображение в конец документа
      const insertedImage = body.appendImage(imageBlob);
      console.log('Изображение успешно вставлено. ID:', imageId);
      // Дополнительная настройка размера и положения
      // configureImageInDoc_(insertedImage, 200, 150); 
    } catch (e) {
      console.error('Ошибка вставки изображения %s в документ: %s', imageId, e);
      DocumentApp.getUi().alert('Не удалось вставить изображение.');
    }
  } else {
    DocumentApp.getUi().alert('Файл изображения не найден на Диске.');
  }
}

/**
 * Настраивает размер вставленного изображения в Google Docs.
 * @param {GoogleAppsScript.Document.InlineImage} image Объект вставленного изображения.
 * @param {number} width Желаемая ширина в пунктах.
 * @param {number} height Желаемая высота в пунктах.
 */
function configureImageInDoc_(image: GoogleAppsScript.Document.InlineImage, width: number, height: number): void {
  // Получаем исходные размеры для сохранения пропорций (опционально)
  // const originalWidth = image.getWidth();
  // const originalHeight = image.getHeight();
  // const aspectRatio = originalWidth / originalHeight;
  // image.setWidth(width);
  // image.setHeight(width / aspectRatio); 
  
  image.setWidth(width);
  image.setHeight(height);
}

// Пример вызова:
// insertImageIntoDoc('YOUR_IMAGE_FILE_ID');

/**
 * Вставляет изображение из Google Диска в указанную ячейку активного листа Google Таблицы.
 * @param {string} imageId ID файла изображения на Google Диске.
 * @param {string} cellNotation Нотация ячейки (например, 'A1', 'B5').
 * @param {number} [offsetX=0] Смещение по X внутри ячейки (в пикселях).
 * @param {number} [offsetY=0] Смещение по Y внутри ячейки (в пикселях).
 */
function insertImageIntoSheet(imageId: string, cellNotation: string, offsetX: number = 0, offsetY: number = 0): void {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const range = sheet.getRange(cellNotation);

  const imageFile = getImageFileFromDrive_(imageId);

  if (imageFile) {
    try {
      const imageBlob = imageFile.getBlob();
      // Вставляем изображение в левый верхний угол указанной ячейки
      const insertedImage = sheet.insertImage(imageBlob, range.getColumn(), range.getRow(), offsetX, offsetY);
      console.log('Изображение успешно вставлено в ячейку %s. ID:', cellNotation, imageId);
      // Дополнительная настройка
      // configureImageInSheet_(insertedImage, 100, 75);
    } catch (e) {
      console.error('Ошибка вставки изображения %s в таблицу: %s', imageId, e);
      SpreadsheetApp.getUi().alert('Не удалось вставить изображение.');
    }
  } else {
    SpreadsheetApp.getUi().alert('Файл изображения не найден на Диске.');
  }
}

/**
 * Настраивает размер вставленного изображения в Google Sheets.
 * Примечание: Изменение размера может быть ограничено возможностями API.
 * @param {GoogleAppsScript.Spreadsheet.OverGridImage} image Объект вставленного изображения.
 * @param {number} width Желаемая ширина в пикселях.
 * @param {number} height Желаемая высота в пикселях.
 */
function configureImageInSheet_(image: GoogleAppsScript.Spreadsheet.OverGridImage, width: number, height: number): void {
  // API OverGridImage может не предоставлять прямых методов setWidth/setHeight,
  // но можно попробовать установить якорь или использовать другие доступные методы.
  // На момент написания статьи, прямое изменение размера после вставки ограничено.
  // Размер обычно определяется при вставке или автоматически.
  // Можно пере-вставить с другими параметрами или использовать альтернативы.
  
  // Пример установки альтернативного текста:
  image.setAltTextTitle('Динамическое изображение');
  image.setAltTextDescription(`Вставлено из файла ${image.getBlob()?.getName() || 'неизвестно'}`);
}

// Пример вызова:
// insertImageIntoSheet('YOUR_IMAGE_FILE_ID', 'C3');

/**
 * Вставляет изображение из Google Диска на указанный слайд активной презентации.
 * @param {string} imageId ID файла изображения на Google Диске.
 * @param {number} slideIndex Индекс слайда (начиная с 0).
 */
function insertImageIntoSlide(imageId: string, slideIndex: number): void {
  const presentation = SlidesApp.getActivePresentation();
  const slides = presentation.getSlides();

  if (slideIndex = slides.length) {
    console.error('Неверный индекс слайда: %s. Всего слайдов: %s', slideIndex, slides.length);
    SlidesApp.getUi().alert('Указан неверный номер слайда.');
    return;
  }

  const slide = slides[slideIndex];
  const imageFile = getImageFileFromDrive_(imageId);

  if (imageFile) {
    try {
      const imageBlob = imageFile.getBlob();
      // Вставляем изображение на слайд
      const insertedImage = slide.insertImage(imageBlob);
      console.log('Изображение успешно вставлено на слайд %s. ID:', slideIndex, imageId);
      // Настройка положения и размера
      // configureImageInSlide_(insertedImage, 50, 50, 300, 200);
    } catch (e) {
      console.error('Ошибка вставки изображения %s на слайд %s: %s', imageId, slideIndex, e);
      SlidesApp.getUi().alert('Не удалось вставить изображение.');
    }
  } else {
    SlidesApp.getUi().alert('Файл изображения не найден на Диске.');
  }
}

/**
 * Настраивает положение и размер изображения на слайде Google Slides.
 * @param {GoogleAppsScript.Slides.Image} image Объект вставленного изображения.
 * @param {number} left Отступ слева от края слайда (в пунктах).
 * @param {number} top Отступ сверху от края слайда (в пунктах).
 * @param {number} width Ширина изображения (в пунктах).
 * @param {number} height Высота изображения (в пунктах).
 */
function configureImageInSlide_(image: GoogleAppsScript.Slides.Image, left: number, top: number, width: number, height: number): void {
  image.setLeft(left);
  image.setTop(top);
  image.setWidth(width);
  image.setHeight(height);
  // Или масштабирование:
  // image.scaleWidth(0.5); // Уменьшить ширину в 2 раза
  // image.scaleHeight(0.5); // Уменьшить высоту в 2 раза
}

// Пример вызова:
// insertImageIntoSlide('YOUR_IMAGE_FILE_ID', 0); // Вставить на первый слайд