Google Sheets – популярная облачная программа для работы с электронными таблицами, предлагающая широкий спектр функций для обработки и анализа данных. Одной из распространенных задач при работе с несколькими листами в Google Sheets является программное получение имени определенного листа. В этой статье мы рассмотрим различные методы решения этой задачи, приведя попутно примеры кода.

Метод 1: использование метода getSheetByName()
Пример кода:

function getSheetName() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Sheet1');
  var sheetName = sheet.getName();
  Logger.log(sheetName);
}

Объяснение:
Метод getSheetByName() — это встроенная функция в скрипте Google Apps, позволяющая получить объект листа по его имени. Получив объект листа, вы можете использовать метод getName()для получения имени листа.

Метод 2: использование метода getActiveSheet()
Пример кода:

function getSheetName() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var sheetName = sheet.getName();
  Logger.log(sheetName);
}

Объяснение:
Метод getActiveSheet()возвращает активный в данный момент лист электронной таблицы. Вызвав метод getName()объекта листа, вы можете получить имя активного листа.

Метод 3. Использование метода getSheets()
Пример кода:

function getSheetName() {
  var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
  for (var i = 0; i < sheets.length; i++) {
    var sheetName = sheets[i].getName();
    Logger.log(sheetName);
  }
}

Объяснение:
Метод getSheets()возвращает массив всех листов активной электронной таблицы. Перебирая этот массив, вы можете получить доступ к имени каждого листа с помощью метода getName().

Метод 4. Использование метода getSheetId()
Пример кода:

function getSheetName() {
  var sheetId = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getSheetId();
  var sheetName = SpreadsheetApp.getActiveSpreadsheet().getSheetNameById(sheetId);
  Logger.log(sheetName);
}

Объяснение:
Метод getSheetId()возвращает идентификатор активного в данный момент листа. Передав этот идентификатор методу getSheetNameById(), вы можете получить имя листа.

Метод 5: использование опции пользовательского меню
Пример кода:

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('Custom Menu')
    .addItem('Get Sheet Name', 'getSheetName')
    .addToUi();
}
function getSheetName() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var sheetName = sheet.getName();
  SpreadsheetApp.getUi().alert('Sheet Name: ' + sheetName);
}

Объяснение.
Этот метод предполагает создание специального пункта меню в Google Таблицах. Функция onOpen()создает новое меню под названием «Пользовательское меню» и добавляет элемент, вызывающий функцию getSheetName(). Когда пользователь выбирает этот пункт меню, в диалоговом окне отображается имя активного листа.

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