Google Apps Script: Как получить имя файла?

/**
 * Получает имя файла Google Drive по его идентификатору.
 *
 * @param {string} fileId Идентификатор файла.
 * @return {string | null} Имя файла или null, если файл не найден или произошла ошибка.
 */
function getFileNameById_(fileId: string): string | null {
  try {
    const file: GoogleAppsScript.Drive.File = DriveApp.getFileById(fileId);
    return file.getName();
  } catch (e: unknown) {
    // Обработка случая, если ID недействителен или нет доступа
    Logger.log(`Ошибка получения файла по ID '${fileId}': ${(e as Error).message}`);
    return null;
  }
}

/**
 * Получает имена всех файлов с заданным именем в корневой папке Диска.
 *
 * @param {string} fileName Имя файла для поиска.
 * @return {string[]} Массив имен найденных файлов.
 */
function getFileNamesByName_(fileName: string): string[] {
  const fileIterator: GoogleAppsScript.Drive.FileIterator = DriveApp.getFilesByName(fileName);
  const names: string[] = [];
  while (fileIterator.hasNext()) {
    const file: GoogleAppsScript.Drive.File = fileIterator.next();
    names.push(file.getName());
  }
  return names;
}

// Пример использования:
function logFileNames(): void {
  const fileId: string = 'YOUR_FILE_ID'; // Замените на реальный ID файла
  const nameById: string | null = getFileNameById_(fileId);
  if (nameById) {
    Logger.log(`Имя файла по ID ${fileId}: ${nameById}`);
  } else {
    Logger.log(`Файл с ID ${fileId} не найден.`);
  }

  const searchName: string = 'Отчет за квартал';
  const namesByName: string[] = getFileNamesByName_(searchName);
  Logger.log(`Файлы с именем '${searchName}': ${namesByName.join(', ')}`);
}

/**
 * Получает имя активной Google Таблицы.
 *
 * @return {string} Имя активной таблицы.
 */
function getActiveSheetName(): string {
  const spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  return spreadsheet.getName();
}

/**
 * Получает имя Google Документа по его ID.
 *
 * @param {string} documentId Идентификатор документа.
 * @return {string | null} Имя документа или null при ошибке.
 */
function getDocumentNameById_(documentId: string): string | null {
  try {
    const doc: GoogleAppsScript.Document.Document = DocumentApp.openById(documentId);
    return doc.getName();
  } catch (e: unknown) {
    Logger.log(`Ошибка открытия документа по ID '${documentId}': ${(e as Error).message}`);
    return null;
  }
}

/**
 * Получает имя Google Презентации по ее ID.
 *
 * @param {string} presentationId Идентификатор презентации.
 * @return {string | null} Имя презентации или null при ошибке.
 */
function getPresentationNameById_(presentationId: string): string | null {
  try {
    // Убедитесь, что API Slides включен в проекте Apps Script
    const presentation: GoogleAppsScript.Slides.Presentation = SlidesApp.openById(presentationId);
    return presentation.getName();
  } catch (e: unknown) {
    Logger.log(`Ошибка открытия презентации по ID '${presentationId}': ${(e as Error).message}`);
    return null;
  }
}

// Пример использования:
function logWorkspaceFileNames(): void {
  Logger.log(`Имя текущей таблицы: ${getActiveSheetName()}`);

  const docId: string = 'YOUR_DOC_ID'; // Замените на ID Документа
  const docName: string | null = getDocumentNameById_(docId);
  if (docName) {
    Logger.log(`Имя документа по ID ${docId}: ${docName}`);
  }

  const presId: string = 'YOUR_PRESENTATION_ID'; // Замените на ID Презентации
  const presName: string | null = getPresentationNameById_(presId);
  if (presName) {
    Logger.log(`Имя презентации по ID ${presId}: ${presName}`);
  }
}

function safeGetFileNameById_(fileId: string): string | null {
  try {
    const file: GoogleAppsScript.Drive.File = DriveApp.getFileById(fileId);
    return file.getName();
  } catch (e) {
    Logger.log(`Файл с ID ${fileId} не найден или доступ запрещен.`);
    return null;
  }
}

/**
 * Находит файлы, содержащие 'Draft' в имени, и добавляет текущую дату.
 *
 * @param {string} folderId ID папки для поиска.
 */
function renameDraftFiles_(folderId: string): void {
  const folder: GoogleAppsScript.Drive.Folder = DriveApp.getFolderById(folderId);
  const files: GoogleAppsScript.Drive.FileIterator = folder.searchFiles('title contains "Draft"');
  const today: string = new Date().toLocaleDateString('ru-RU'); // Формат ДД.ММ.ГГГГ

  while (files.hasNext()) {
    const file: GoogleAppsScript.Drive.File = files.next();
    const currentName: string = file.getName();
    const newName: string = `${currentName.replace('Draft', 'Processed')} - ${today}`;
    try {
      file.setName(newName);
      Logger.log(`Файл '${currentName}' переименован в '${newName}'`);
    } catch (e: unknown) {
      Logger.log(`Не удалось переименовать файл '${currentName}': ${(e as Error).message}`);
    }
  }
}

/**
 * Записывает список файлов из папки в активный лист Google Таблицы.
 *
 * @param {string} folderId ID папки на Google Drive.
 */
function listFilesInSheet_(folderId: string): void {
  try {
    const folder: GoogleAppsScript.Drive.Folder = DriveApp.getFolderById(folderId);
    const files: GoogleAppsScript.Drive.FileIterator = folder.getFiles();
    const sheet: GoogleAppsScript.Spreadsheet.Sheet = SpreadsheetApp.getActiveSheet();

    // Очистка листа (опционально) и добавление заголовков
    sheet.clearContents();
    sheet.appendRow(['File Name', 'File ID']);

    const fileData: string[][] = [];
    while (files.hasNext()) {
      const file: GoogleAppsScript.Drive.File = files.next();
      fileData.push([file.getName(), file.getId()]);
    }

    if (fileData.length > 0) {
      // Запись данных одним пакетом для производительности
      sheet.getRange(sheet.getLastRow() + 1, 1, fileData.length, 2).setValues(fileData);
      Logger.log(`Добавлено ${fileData.length} файлов из папки '${folder.getName()}' в таблицу.`);
    } else {
      Logger.log(`Папка '${folder.getName()}' пуста.`);
    }

  } catch (e: unknown) {
    Logger.log(`Ошибка при листинге файлов из папки ${folderId}: ${(e as Error).message}`);
  }
}