Как сделать копию файла с помощью Google Apps Script?

Что такое Google Apps Script и зачем он нужен?

Google Apps Script (GAS) – это облачный язык сценариев, позволяющий автоматизировать задачи в Google Workspace (Sheets, Docs, Drive, Gmail и т.д.). Он основан на JavaScript и предоставляет доступ к различным сервисам Google, давая возможность создавать кастомные решения. GAS идеально подходит для автоматизации рутинных операций, интеграции приложений и расширения функциональности Google Workspace. Например, можно автоматизировать создание копий файлов.

Случаи использования создания копий файлов

Создание копий файлов в Google Drive может быть полезно в разных ситуациях:

Резервное копирование важных документов: Автоматическое создание резервных копий для предотвращения потери данных.

Шаблоны документов: Создание копий шаблонов для новых проектов или клиентов.

Совместная работа: Предоставление копии документа для редактирования, сохраняя оригинал без изменений.

Автоматизация маркетинга: Копирование рекламных материалов для A/B тестирования в контекстной рекламе, где каждая копия содержит небольшие изменения для отслеживания эффективности.

Необходимые условия: доступ к Google Drive и Google Apps Script

Для работы с Google Apps Script необходимо:

Аккаунт Google с доступом к Google Drive.

Базовые знания JavaScript.

Открытый редактор Google Apps Script (доступен из Google Drive: Создать > Другое > Google Apps Script).

Основные методы создания копий файлов

Использование DriveApp.getFileById() для получения файла

Чтобы скопировать файл, сначала нужно получить к нему доступ. Это делается с помощью DriveApp.getFileById(fileId), где fileId – это уникальный идентификатор файла в Google Drive. Этот ID можно найти в URL файла.

/**
 * @param {string} fileId ID файла в Google Drive.
 * @return {GoogleAppsScript.Drive.File} Объект файла.
 */
function getFile(fileId: string): GoogleAppsScript.Drive.File {
  try {
    const file = DriveApp.getFileById(fileId);
    return file;
  } catch (e) {
    Logger.log('Ошибка при получении файла: ' + e);
    return null;
  }
}

Метод makeCopy(): создание простой копии файла

После получения файла используется метод makeCopy(), который создает его копию в корневом каталоге Google Drive.

/**
 * @param {GoogleAppsScript.Drive.File} file Объект файла для копирования.
 */
function copyFile(file: GoogleAppsScript.Drive.File): void {
  try {
    file.makeCopy();
    Logger.log('Файл успешно скопирован.');
  } catch (e) {
    Logger.log('Ошибка при копировании файла: ' + e);
  }
}

Примеры кода: создание копии с новым именем

Следующий пример демонстрирует, как создать копию файла с новым именем:

/**
 * @param {string} fileId ID исходного файла.
 * @param {string} newName Новое имя для копии файла.
 */
function copyFileWithNewName(fileId: string, newName: string): void {
  try {
    const file = DriveApp.getFileById(fileId);
    file.makeCopy(newName);
    Logger.log('Файл успешно скопирован с новым именем: ' + newName);
  } catch (e) {
    Logger.log('Ошибка при копировании файла: ' + e);
  }
}

// Пример использования:
// copyFileWithNewName('ваш_fileId', 'Новая копия файла');

Расширенные возможности: настройки и параметры копирования

Указание папки назначения для копии

Можно указать папку, в которой будет создана копия, используя метод makeCopy(name, destinationFolder). Сначала необходимо получить объект папки:

/**
 * @param {string} folderId ID папки назначения.
 * @return {GoogleAppsScript.Drive.Folder} Объект папки.
 */
function getFolder(folderId: string): GoogleAppsScript.Drive.Folder {
  try {
    const folder = DriveApp.getFolderById(folderId);
    return folder;
  } catch (e) {
    Logger.log('Ошибка при получении папки: ' + e);
    return null;
  }
}

Затем, используйте этот объект при создании копии:

/**
 * @param {string} fileId ID исходного файла.
 * @param {string} newName Новое имя для копии файла.
 * @param {string} folderId ID папки назначения.
 */
function copyFileToFolder(fileId: string, newName: string, folderId: string): void {
  try {
    const file = DriveApp.getFileById(fileId);
    const folder = DriveApp.getFolderById(folderId);
    file.makeCopy(newName, folder);
    Logger.log('Файл успешно скопирован в папку: ' + folder.getName());
  } catch (e) {
    Logger.log('Ошибка при копировании файла: ' + e);
  }
}

// Пример использования:
// copyFileToFolder('ваш_fileId', 'Новая копия файла', 'ваш_folderId');

Изменение прав доступа к созданной копии

Google Apps Script позволяет управлять правами доступа к файлам. После создания копии можно изменить права доступа для пользователей или групп:

file.setSharing(Access.DOMAIN, Permission.EDIT) – предоставить доступ на редактирование всем в домене.

file.addEditor(email) – предоставить доступ на редактирование конкретному пользователю.

file.addViewers(emails) – предоставить доступ на просмотр списку пользователей.

Пример:

/**
 * @param {string} fileId ID файла для изменения прав доступа.
 * @param {string} email Email пользователя, которому предоставляется доступ.
 */
function shareFile(fileId: string, email: string): void {
  try {
    const file = DriveApp.getFileById(fileId);
    file.addEditor(email);
    Logger.log('Доступ предоставлен пользователю: ' + email);
  } catch (e) {
    Logger.log('Ошибка при предоставлении доступа: ' + e);
  }
}

// Пример использования:
// shareFile('ваш_fileId', 'user@example.com');

Добавление метаданных к копии файла

К файлам можно добавлять метаданные (custom properties), например, для хранения информации о процессе копирования или об источнике файла:

/**
 * @param {string} fileId ID файла для добавления метаданных.
 * @param {string} key Ключ метаданных.
 * @param {string} value Значение метаданных.
 */
function addMetadataToFile(fileId: string, key: string, value: string): void {
  try {
    const file = DriveApp.getFileById(fileId);
    const properties = PropertiesService.getDocumentProperties();
    properties.setProperty(key, value);
    Logger.log('Метаданные добавлены к файлу: ' + key + ' = ' + value);
  } catch (e) {
    Logger.log('Ошибка при добавлении метаданных: ' + e);
  }
}

// Пример использования:
// addMetadataToFile('ваш_fileId', 'sourceFileId', 'исходный_fileId');

Автоматизация процесса копирования файлов

Создание триггеров для автоматического копирования

Google Apps Script позволяет создавать триггеры, которые автоматически запускают скрипт при определенных событиях. Например, можно создать триггер, который будет копировать файл при его создании или изменении. Для этого используется метод ScriptApp.newTrigger(functionName).

Копирование файлов при загрузке в определенную папку

Можно настроить триггер, который будет срабатывать при загрузке нового файла в определенную папку. Для этого нужно использовать тип триггера Drive.Files.Insert и указать папку, за которой нужно следить.

Примеры сценариев: резервное копирование документов

Например, можно создать скрипт, который будет ежедневно копировать все файлы из определенной папки в папку резервных копий:

/**
 * Функция для ежедневного резервного копирования файлов.
 */
function backupFiles(): void {
  const sourceFolderId = 'ID_исходной_папки';
  const backupFolderId = 'ID_папки_резервных_копий';
  const sourceFolder = DriveApp.getFolderById(sourceFolderId);
  const backupFolder = DriveApp.getFolderById(backupFolderId);
  const files = sourceFolder.getFiles();

  while (files.hasNext()) {
    const file = files.next();
    file.makeCopy(file.getName(), backupFolder);
  }
  Logger.log('Резервное копирование завершено.');
}

// Функция для установки триггера (запустить один раз вручную):
function createTimeDrivenTrigger(): void {
  ScriptApp.newTrigger('backupFiles')
    .timeBased()
    .everyDays(1)
    .atHour(3) // 3 часа ночи
    .create();
}

Обработка ошибок и отладка

Как обрабатывать ошибки при копировании файлов

Важно обрабатывать ошибки, которые могут возникнуть при копировании файлов. Используйте блоки try...catch для перехвата исключений и логирования информации об ошибках. Это поможет быстро выявлять и устранять проблемы.

Распространенные ошибки и способы их устранения

Отсутствие доступа к файлу: Убедитесь, что у скрипта есть права на чтение и запись файлов.

Неверный ID файла или папки: Проверьте правильность указанных идентификаторов.

Превышение лимитов Google Apps Script: Оптимизируйте код для уменьшения потребления ресурсов.

Советы по отладке скриптов Google Apps Script

Используйте Logger.log(): Добавляйте логи в ключевых местах кода для отслеживания хода выполнения и значений переменных.

Проверяйте права доступа: Убедитесь, что скрипт имеет необходимые разрешения для работы с файлами и папками.

Используйте отладчик: Редактор Google Apps Script предоставляет встроенный отладчик, позволяющий пошагово выполнять код и анализировать его состояние.