Google Apps Script: Получение листа по ID

/**
 * Получает и выводит в лог ID активного листа.
 */
function logActiveSheetId(): void {
  const activeSheet: GoogleAppsScript.Spreadsheet.Sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const sheetId: number = activeSheet.getSheetId();
  Logger.log(`ID активного листа: ${sheetId}`);
}

// Получение активной таблицы (к которой привязан скрипт)
const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Получение таблицы по ее ID (для автономных скриптов или работы с другими таблицами)
const spreadsheetId: string = 'YOUR_SPREADSHEET_ID'; // Замените на реальный ID таблицы
const ssById: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.openById(spreadsheetId);

/**
 * Находит лист в таблице по его числовому ID.
 *
 * @param {GoogleAppsScript.Spreadsheet.Spreadsheet} spreadsheet Объект таблицы.
 * @param {number} sheetId Идентификатор искомого листа.
 * @returns {GoogleAppsScript.Spreadsheet.Sheet | null} Объект листа или null, если лист не найден.
 */
function getSheetById_(spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet, sheetId: number): GoogleAppsScript.Spreadsheet.Sheet | null {
  const sheets: GoogleAppsScript.Spreadsheet.Sheet[] = spreadsheet.getSheets();
  for (const sheet of sheets) {
    if (sheet.getSheetId() === sheetId) {
      return sheet;
    }
  }
  return null; // Лист с таким ID не найден
}

// Пример использования:
function testGetSheetById(): void {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const targetSheetId: number = 123456789; // Замените на ID нужного листа

  const targetSheet: GoogleAppsScript.Spreadsheet.Sheet | null = getSheetById_(ss, targetSheetId);

  if (targetSheet) {
    Logger.log(`Найден лист с ID ${targetSheetId}: ${targetSheet.getName()}`);
    // Дальнейшие операции с листом targetSheet
    // targetSheet.getRange('A1').setValue('Найден по ID');
  } else {
    Logger.log(`Лист с ID ${targetSheetId} не найден.`);
  }
}

/**
 * Получает лист по его имени.
 */
function getSheetByNameExample(): void {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheetName: string = 'Отчет по маркетингу';
  const sheet: GoogleAppsScript.Spreadsheet.Sheet | null = ss.getSheetByName(sheetName);

  if (sheet) {
    Logger.log(`Лист "${sheetName}" найден.`);
  } else {
    Logger.log(`Лист "${sheetName}" не найден.`);
  }
}

/**
 * Получает активный лист и выводит его имя.
 */
function getActiveSheetExample(): void {
  const activeSheet: GoogleAppsScript.Spreadsheet.Sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  Logger.log(`Активный лист: ${activeSheet.getName()}`);
}

/**
 * Перебирает все листы и выводит их имена и ID.
 */
function getAllSheetsExample(): void {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheets: GoogleAppsScript.Spreadsheet.Sheet[] = ss.getSheets();

  Logger.log(`Всего листов: ${sheets.length}`);
  sheets.forEach((sheet: GoogleAppsScript.Spreadsheet.Sheet, index: number) => {
    Logger.log(`Лист ${index + 1}: Имя='${sheet.getName()}', ID=${sheet.getSheetId()}`);
  });
}

/**
 * Копирует данные о расходах из листа-источника в лист-приемник, используя их ID.
 */
function copyAdSpendDataById(): void {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheetId: number = 111222333; // Замените на ID листа-источника
  const targetSheetId: number = 444555666; // Замените на ID листа-приемника

  const sourceSheet: GoogleAppsScript.Spreadsheet.Sheet | null = getSheetById_(ss, sourceSheetId);
  const targetSheet: GoogleAppsScript.Spreadsheet.Sheet | null = getSheetById_(ss, targetSheetId);

  if (sourceSheet && targetSheet) {
    const sourceRange: GoogleAppsScript.Spreadsheet.Range = sourceSheet.getRange('A:C');
    const sourceValues: any[][] = sourceRange.getValues();

    // Очищаем целевой лист перед вставкой (опционально)
    targetSheet.getDataRange().clearContent(); 

    // Вставляем данные
    targetSheet.getRange(1, 1, sourceValues.length, sourceValues[0].length).setValues(sourceValues);
    Logger.log(`Данные скопированы из листа '${sourceSheet.getName()}' в лист '${targetSheet.getName()}'.`);

  } else {
    if (!sourceSheet) {
      Logger.log(`Ошибка: Лист-источник с ID ${sourceSheetId} не найден.`);
    }
    if (!targetSheet) {
      Logger.log(`Ошибка: Лист-приемник с ID ${targetSheetId} не найден.`);
    }
  }
}

/** Вспомогательная функция (см. выше) **/
function getSheetById_(spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet, sheetId: number): GoogleAppsScript.Spreadsheet.Sheet | null { /* ... */ }

/**
 * Анализирует данные о конверсиях только на листе с заданным ID.
 */
function analyzeConversionsOnSpecificSheet(): void {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const conversionSheetId: number = 987654321; // Замените на ID листа с данными о конверсиях

  const activeSheet: GoogleAppsScript.Spreadsheet.Sheet = ss.getActiveSheet();

  // Проверяем, является ли активный лист нужным нам листом
  if (activeSheet.getSheetId() === conversionSheetId) {
    // Логика анализа данных конверсий
    const dataRange: GoogleAppsScript.Spreadsheet.Range = activeSheet.getDataRange();
    const data: any[][] = dataRange.getValues();
    // ... ваш код анализа данных ...
    Logger.log(`Анализ данных на листе '${activeSheet.getName()}' выполнен.`);
    SpreadsheetApp.getUi().alert(`Анализ данных на листе '${activeSheet.getName()}' выполнен.`);
  } else {
    Logger.log(`Скрипт предназначен для запуска только на листе с ID ${conversionSheetId}. Текущий лист: ${activeSheet.getName()} (ID: ${activeSheet.getSheetId()}).`);
    SpreadsheetApp.getUi().alert(`Пожалуйста, переключитесь на лист с данными о конверсиях (ID: ${conversionSheetId}) и запустите скрипт снова.`);
  }
}

/**
 * Вызывается при открытии таблицы, добавляет пользовательское меню.
 */
function onOpen(): void {
  SpreadsheetApp.getUi()
    .createMenu('Навигация по Листам')
    .addItem('Перейти к Отчету (ID: 123)', 'navigateToSheet123')
    .addItem('Перейти к Данным (ID: 456)', 'navigateToSheet456')
    .addToUi();
}

/**
 * Активирует лист с ID 123456789.
 */
function navigateToSheet123(): void {
  navigateToSheetById_(123456789); // Замените на реальный ID
}

/**
 * Активирует лист с ID 987654321.
 */
function navigateToSheet456(): void {
  navigateToSheetById_(987654321); // Замените на реальный ID
}

/**
 * Активирует лист по его ID.
 *
 * @param {number} sheetId ID листа для активации.
 */
function navigateToSheetById_(sheetId: number): void {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheetToActivate: GoogleAppsScript.Spreadsheet.Sheet | null = getSheetById_(ss, sheetId);

  if (sheetToActivate) {
    sheetToActivate.activate();
  } else {
    SpreadsheetApp.getUi().alert(`Лист с ID ${sheetId} не найден.`);
  }
}

/** Вспомогательная функция (см. выше) **/
function getSheetById_(spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet, sheetId: number): GoogleAppsScript.Spreadsheet.Sheet | null { /* ... */ }

const sheet: GoogleAppsScript.Spreadsheet.Sheet | null = getSheetById_(ss, someId);
if (sheet) {
  // Безопасно работаем с sheet
} else {
  // Обрабатываем ситуацию: логируем ошибку, уведомляем пользователя и т.д.
  Logger.log(`Критическая ошибка: Лист с ID ${someId} не существует.`);
}

try {
  const sheet: GoogleAppsScript.Spreadsheet.Sheet | null = getSheetById_(ss, criticalSheetId);
  if (!sheet) {
    throw new Error(`Лист с критически важным ID ${criticalSheetId} не найден!`);
  }
  // ... операции с листом ...
} catch (error) {
  Logger.log(`Произошла ошибка: ${error.message} в стеке ${error.stack}`);
  // Дополнительные действия по обработке ошибки (например, уведомление администратора)
}