Class SpreadsheetApp

Приложение для электронных таблиц

Доступ и создание файлов Google Sheets. Этот класс является родительским классом для службы электронных таблиц .

Характеристики

Свойство Тип Описание
AutoFillSeries AutoFillSeries Перечисление типов рядов, используемых для расчета автоматически заполняемых значений.
BandingTheme BandingTheme Перечень возможных тем оформления.
BooleanCriteria BooleanCriteria Перечисление логических критериев условного форматирования.
BorderStyle BorderStyle Перечисление допустимых стилей для установки границ Range .
ColorType ColorType Перечисление возможных цветотипов.
CopyPasteType CopyPasteType Перечень возможных типов пасты.
DataExecutionErrorCode DataExecutionErrorCode Перечень возможных кодов ошибок выполнения данных.
DataExecutionState DataExecutionState Перечисление возможных состояний выполнения данных.
DataSourceParameterType DataSourceParameterType Перечисление возможных типов параметров источника данных.
DataSourceRefreshScope DataSourceRefreshScope Перечень возможных областей обновления источника данных.
DataSourceType DataSourceType Перечисление возможных типов источников данных.
DataValidationCriteria DataValidationCriteria Перечисление, представляющее критерии проверки данных, которые можно задать для диапазона.
DateTimeGroupingRuleType DateTimeGroupingRuleType Перечисление правила группировки даты и времени.
DeveloperMetadataLocationType DeveloperMetadataLocationType Перечень возможных типов расположения метаданных разработчика.
DeveloperMetadataVisibility DeveloperMetadataVisibility Перечень возможных возможностей видимости метаданных разработчика.
Dimension Dimension Перечисление возможных размеров электронной таблицы.
Direction Direction Перечень возможных направлений, в которых можно перемещаться по электронной таблице с помощью клавиш со стрелками.
FrequencyType FrequencyType Перечень возможных типов частот.
GroupControlTogglePosition GroupControlTogglePosition Перечень положений, в которых может находиться переключатель группового управления.
InterpolationType InterpolationType Перечисление типов интерполяции градиента условного формата.
PivotTableSummarizeFunction PivotTableSummarizeFunction Перечисление функций, которые можно использовать для суммирования значений в сводной таблице.
PivotValueDisplayType PivotValueDisplayType Перечисление способов отображения сводного значения.
ProtectionType ProtectionType Перечисление, представляющее части электронной таблицы, которые можно защитить от изменений.
RecalculationInterval RecalculationInterval Перечисление возможных интервалов, которые можно использовать при пересчете электронной таблицы.
RelativeDate RelativeDate Перечисление параметров относительной даты для вычисления значения, которое будет использоваться в BooleanCriteria на основе даты.
SheetType SheetType Перечисление различных типов листов, которые могут существовать в электронной таблице.
SortOrder SortOrder Перечисление порядка сортировки.
TextDirection TextDirection Перечень допустимых направлений текста.
TextToColumnsDelimiter TextToColumnsDelimiter Перечисление предустановленных разделителей для разделения текста по столбцам.
ThemeColorType ThemeColorType Перечень возможных цветовых типов темы.
ValueType ValueType Перечисление типов значений, возвращаемых методами Range.getValue() и Range.getValues() из класса Range службы электронных таблиц. Перечисленные ниже значения перечисления дополняют Number , Boolean , Date или String .
WrapStrategy WrapStrategy Перечень стратегий, используемых для переноса ячеек.

Методы

Метод Тип возврата Краткое описание
create(name) Spreadsheet Создает новую электронную таблицу с заданным именем.
create(name, rows, columns) Spreadsheet Создает новую электронную таблицу с заданным именем и указанным количеством строк и столбцов.
enableAllDataSourcesExecution() void Включает выполнение данных для всех типов источников данных.
enableBigQueryExecution() void Включает выполнение данных для источников данных BigQuery.
enableLookerExecution() void Включает выполнение данных для источников данных Looker.
flush() void Применяет все ожидающие изменения таблицы.
getActive() Spreadsheet Возвращает текущую активную электронную таблицу или null , если ее нет.
getActiveRange() Range Возвращает выбранный диапазон на активном листе или null , если активного диапазона нет.
getActiveRangeList() RangeList Возвращает список активных диапазонов на активном листе или null , если диапазоны не выбраны.
getActiveSheet() Sheet Получает активный лист в электронной таблице.
getActiveSpreadsheet() Spreadsheet Возвращает текущую активную электронную таблицу или null , если ее нет.
getCurrentCell() Range Возвращает текущую (выделенную) ячейку, выбранную в одном из активных диапазонов на активном листе, или null если текущей ячейки нет.
getSelection() Selection Возвращает текущий Selection в электронной таблице.
getUi() Ui Возвращает экземпляр среды пользовательского интерфейса электронной таблицы, который позволяет сценарию добавлять такие функции, как меню, диалоговые окна и боковые панели.
newCellImage() CellImageBuilder Создает построитель для CellImage .
newColor() ColorBuilder Создает построитель для Color .
newConditionalFormatRule() ConditionalFormatRuleBuilder Создает построитель для правила условного форматирования.
newDataSourceSpec() DataSourceSpecBuilder Создает построитель для DataSourceSpec .
newDataValidation() DataValidationBuilder Создает построитель для правила проверки данных.
newFilterCriteria() FilterCriteriaBuilder Создает построитель для FilterCriteria .
newRichTextValue() RichTextValueBuilder Создает построитель для значения форматированного текста.
newTextStyle() TextStyleBuilder Создает построитель для текстового стиля.
open(file) Spreadsheet Открывает электронную таблицу, соответствующую данному объекту File.
openById(id) Spreadsheet Открывает таблицу с указанным идентификатором.
openByUrl(url) Spreadsheet Открывает таблицу с указанным URL-адресом.
setActiveRange(range) Range Устанавливает указанный диапазон в качестве active range , при этом верхняя левая ячейка диапазона становится current cell .
setActiveRangeList(rangeList) RangeList Устанавливает указанный список диапазонов в качестве active ranges .
setActiveSheet(sheet) Sheet Устанавливает активный лист в электронной таблице.
setActiveSheet(sheet, restoreSelection) Sheet Устанавливает активный лист в электронной таблице с возможностью восстановить самый последний выбор на этом листе.
setActiveSpreadsheet(newActiveSpreadsheet) void Устанавливает активную электронную таблицу.
setCurrentCell(cell) Range Устанавливает указанную ячейку в качестве current cell .

Подробная документация

create(name)

Создает новую электронную таблицу с заданным именем. 

// The code below creates a new spreadsheet "Finances" and logs the URL for it
var ssNew = SpreadsheetApp.create("Finances");
Logger.log(ssNew.getUrl());

Параметры

Имя Тип Описание
name String Имя электронной таблицы.

Возвращаться

Spreadsheet — новая электронная таблица

Авторизация

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

  • https://www.googleapis.com/auth/spreadsheets

create(name, rows, columns)

Создает новую электронную таблицу с заданным именем и указанным количеством строк и столбцов. 

// The code below creates a new spreadsheet "Finances" with 50 rows and 5 columns and logs the
// URL for it
var ssNew = SpreadsheetApp.create("Finances", 50, 5);
Logger.log(ssNew.getUrl());

Параметры

Имя Тип Описание
name String Имя электронной таблицы.
rows Integer Количество строк в электронной таблице.
columns Integer Количество столбцов в электронной таблице.

Возвращаться

Spreadsheet — новая электронная таблица

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets

enableAllDataSourcesExecution()

Включает выполнение данных для всех типов источников данных.

При выполнении данных выдается исключение, если тип источника данных не включен. Используйте этот метод, чтобы включить выполнение данных для всех типов источников данных. 

// Turns data execution on for all types of data sources.
SpreadsheetApp.enableAllDataSourcesExecution();

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets the first data source sheet in the spreadsheet and refreshes the data.
ss.getDataSourceSheets()[0].refreshData();

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/bigquery.readonly

enableBigQueryExecution()

Включает выполнение данных для источников данных BigQuery.

Выполнение данных для источника данных BigQuery выдает исключение, если оно не включено. 

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets the first data source sheet in the spreadsheet and refreshes the BigQuery data.
ss.getDataSourceSheets()[0].refreshData();

Авторизация

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

  • https://www.googleapis.com/auth/bigquery.readonly

enableLookerExecution()

Включает выполнение данных для источников данных Looker.

Выполнение данных для источника данных Looker выдает исключение, если оно не включено. 

// Turns data execution on for Looker data sources.
SpreadsheetApp.enableLookerExecution();

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets the first data source sheet in the spreadsheet and refreshes the associated Looker
// data.
ss.getDataSourceSheets()[0].refreshData();

flush()

Применяет все ожидающие изменения таблицы.

Операции с электронными таблицами иногда объединяются для повышения производительности, например, при выполнении нескольких вызовов Range.getValue(). Однако иногда вам может потребоваться убедиться, что все ожидающие изменения внесены сразу, например, чтобы показать данные пользователя во время выполнения сценария. 

// The code below changes the background color of cells A1 and B1 twenty times. You should be
// able to see the updates live in the spreadsheet. If flush() is not called, the updates may
// be applied live or may all be applied at once when the script completes.
function colors() {
  var sheet = SpreadsheetApp.getActiveSheet();
  for (var i = 0; i < 20; i++) {
    if ((i % 2) == 0) {
      sheet.getRange('A1').setBackground('green');
      sheet.getRange('B1').setBackground('red');
    } else {
      sheet.getRange('A1').setBackground('red');
      sheet.getRange('B1').setBackground('green');
    }
    SpreadsheetApp.flush();
  }
}

getActive()

Возвращает текущую активную электронную таблицу или null , если ее нет.

Функции, выполняемые в контексте электронной таблицы, могут получить ссылку на соответствующий объект электронной таблицы, вызвав эту функцию. 

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActive().getUrl());

Возвращаться

Spreadsheet — активный объект электронной таблицы.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRange()

Возвращает выбранный диапазон на активном листе или null , если активного диапазона нет. Если выбрано несколько диапазонов, этот метод возвращает только последний выбранный диапазон.

Обычно это означает диапазон, выбранный пользователем на активном листе, но в пользовательской функции он относится к активно пересчитываемой ячейке. 

// The code below logs the background color for the active range.
var colorObject = SpreadsheetApp.getActiveRange().getBackgroundObject();
// Assume the color has ColorType.RGB.
Logger.log(colorObject.asRgbColor().asHexString());

Возвращаться

Range — активный диапазон.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRangeList()

Возвращает список активных диапазонов на активном листе или null , если диапазоны не выбраны. Активный диапазон, содержащий текущую выделенную ячейку, помещается последним в списке.

Если выбран один диапазон, это ведет себя как вызов getActiveRange() . 

// Returns the list of active ranges.
var rangeList = SpreadsheetApp.getActiveRangeList();

Возвращаться

RangeList — список активных диапазонов

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveSheet()

Получает активный лист в электронной таблице.

Активный лист в электронной таблице — это лист, который отображается в пользовательском интерфейсе электронной таблицы. 

// The code below logs the name of the active sheet.
Logger.log(SpreadsheetApp.getActiveSheet().getName());

Возвращаться

Sheet — активный объект Листа.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveSpreadsheet()

Возвращает текущую активную электронную таблицу или null , если ее нет.

Функции, выполняемые в контексте электронной таблицы, могут получить ссылку на соответствующий объект Spreadsheet , вызвав эту функцию. 

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getUrl());

Возвращаться

Spreadsheet — активный объект электронной таблицы.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCurrentCell()

Возвращает текущую (выделенную) ячейку, выбранную в одном из активных диапазонов на активном листе, или null если текущей ячейки нет. 

// Returns the current highlighted cell in the one of the active ranges.
var currentCell = SpreadsheetApp.getCurrentCell();

Возвращаться

Range — текущая ячейка

Авторизация

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSelection()

Возвращает текущий Selection в электронной таблице. 

var selection = SpreadsheetApp.getSelection();
var currentCell = selection.getCurrentCell();

Возвращаться

Selection — текущий выбор

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getUi()

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

// Add a custom menu to the active spreadsheet, including a separator and a sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SpreadsheetApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Возвращаться

Ui — экземпляр среды пользовательского интерфейса этой электронной таблицы.

newCellImage()

Создает построитель для CellImage . 

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 on Sheet1.
const range = sheet.getRange('A1');

// Builds an image using a source URL.
const cellImage = SpreadsheetApp.newCellImage()
  .setSourceUrl('https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png')
  .build();

// Sets the image in cell A1.
range.setValue(cellImage);

Возвращаться

CellImageBuilder — Новый построитель.

newColor()

Создает построитель для Color . 

var rgbColor = SpreadsheetApp.newColor().setRgbColor("#FF0000").build();

Возвращаться

ColorBuilder — Новый конструктор.

newConditionalFormatRule()

Создает построитель для правила условного форматирования. 

// Adds a conditional format rule to a sheet that causes all cells in range A1:B3 to turn red
// if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActive().getActiveSheet();
var range = sheet.getRange('A1:B3');
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build()
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Возвращаться

ConditionalFormatRuleBuilder — новый построитель.

newDataSourceSpec()

Создает построитель для DataSourceSpec . 

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Enables BigQuery.
SpreadsheetApp.enableBigQueryExecution();

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
  .asBigQuery()
  .setProjectId('project-id-1')
  .setTableProjectId('bigquery-public-data')
  .setDatasetId('ncaa_basketball')
  .setTableId('mbb_historical_teams_games')
  .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

Возвращаться

DataSourceSpecBuilder — новый построитель.

newDataValidation()

Создает построитель для правила проверки данных. 

var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireNumberBetween(1, 100)
    .setAllowInvalid(false)
    .setHelpText('Number must be between 1 and 100.')
    .build();
cell.setDataValidation(rule);

Возвращаться

DataValidationBuilder — новый построитель.

newFilterCriteria()

Создает построитель для FilterCriteria . 

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the range to A1:D20.
const range = sheet.getRange('A1:D20');

// Creates a filter and applies it to the specified range.
range.createFilter();

// Gets the current filter for the range and creates filter criteria that only shows cells
// that aren't empty.
const filter = range.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();

// Sets the criteria to  column C.
filter.setColumnFilterCriteria(3, criteria);

Возвращаться

FilterCriteriaBuilder — новый конструктор

newRichTextValue()

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

// Sets cell A1 to have the text "Hello world", with "Hello" bolded.
var cell = SpreadsheetApp.getActive().getRange('A1');
var bold = SpreadsheetApp.newTextStyle().setBold(true).build();
var value = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
cell.setRichTextValue(value);

Возвращаться

RichTextValueBuilder — Новый построитель.

newTextStyle()

Создает построитель для текстового стиля. 

// Sets range A1:B3 to have red, size 22, bolded, underlined text.
var range = SpreadsheetApp.getActive().getRange('A1:B3');
var style = SpreadsheetApp.newTextStyle()
    .setForegroundColor("red")
    .setFontSize(22)
    .setBold(true)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Возвращаться

TextStyleBuilder — Новый построитель.

open(file)

Открывает электронную таблицу, соответствующую данному объекту File. 

// Get any starred spreadsheets from Google Drive, then open the spreadsheets and log the name
// of the first sheet within each spreadsheet.
var files = DriveApp.searchFiles(
    'starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"');
while (files.hasNext()) {
  var spreadsheet = SpreadsheetApp.open(files.next());
  var sheet = spreadsheet.getSheets()[0];
  Logger.log(sheet.getName());
}

Параметры

Имя Тип Описание
file File Файл, который нужно открыть.

Возвращаться

Spreadsheet — электронная таблица

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets

openById(id)

Открывает таблицу с указанным идентификатором. Идентификатор электронной таблицы можно извлечь из ее URL-адреса. Например, идентификатор электронной таблицы в URL-адресе https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 — «abc1234567». 

// The code below opens a spreadsheet using its ID and logs the name for it.
// Note that the spreadsheet is NOT physically opened on the client side.
// It is opened on the server only (for modification by the script).
var ss = SpreadsheetApp.openById("abc1234567");
Logger.log(ss.getName());

Параметры

Имя Тип Описание
id String Уникальный идентификатор электронной таблицы.

Возвращаться

Spreadsheet — объект «Электронная таблица» с заданным идентификатором.

Авторизация

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

  • https://www.googleapis.com/auth/spreadsheets

openByUrl(url)

Открывает таблицу с указанным URL-адресом. Выдает исключение сценария, если URL-адрес не существует или у пользователя нет разрешения на доступ к нему. 

// Opens a spreadsheet by its URL and logs its name.
// Note that the spreadsheet doesn't physically open on the client side.
// It opens on the server only (for modification by the script).
var ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit');
console.log(ss.getName());

Параметры

Имя Тип Описание
url String URL-адрес электронной таблицы.

Возвращаться

Spreadsheet — объект электронной таблицы с заданным URL-адресом.

Авторизация

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

  • https://www.googleapis.com/auth/spreadsheets

setActiveRange(range)

Устанавливает указанный диапазон в качестве active range , при этом верхняя левая ячейка диапазона становится current cell .

Пользовательский интерфейс электронной таблицы отображает лист, содержащий выбранный диапазон, и выбирает ячейки, определенные в выбранном диапазоне. 

// The code below sets range C1:D4 in the first sheet as the active range.
var range = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4');
SpreadsheetApp.setActiveRange(range);

var selection = SpreadsheetApp.getSelection();
// Current cell: C1
var currentCell = selection.getCurrentCell();
// Active Range: C1:D4
var activeRange = selection.getActiveRange();

Параметры

Имя Тип Описание
range Range Диапазон, который необходимо сделать активным.

Возвращаться

Range — новый активный диапазон.

setActiveRangeList(rangeList)

Устанавливает указанный список диапазонов в качестве active ranges . Последний диапазон в списке устанавливается как active range . 

// The code below sets ranges [D4, B2:C4] in the active sheet as the active ranges.
var rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']);
SpreadsheetApp.setActiveRangeList(rangeList);

var selection = SpreadsheetApp.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Параметры

Имя Тип Описание
rangeList RangeList Список диапазонов для выбора.

Возвращаться

RangeList — вновь выбранный список диапазонов.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setActiveSheet(sheet)

Устанавливает активный лист в электронной таблице. Пользовательский интерфейс Google Sheets отображает выбранный лист, если только он не принадлежит другой электронной таблице. 

// The code below makes the 2nd sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);

Параметры

Имя Тип Описание
sheet Sheet Новый активный лист.

Возвращаться

Sheet — лист, который стал новым активным листом.

setActiveSheet(sheet, restoreSelection)

Устанавливает активный лист в электронной таблице с возможностью восстановить самый последний выбор на этом листе. Пользовательский интерфейс Google Sheets отображает выбранный лист, если только он не принадлежит другой электронной таблице. 

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Параметры

Имя Тип Описание
sheet Sheet Новый активный лист.
restoreSelection Boolean Если true , последний выбор нового активного листа становится выбранным снова, когда новый лист становится активным; если false , новый лист становится активным без изменения текущего выбора.

Возвращаться

Sheet — новый активный лист.

Авторизация

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setActiveSpreadsheet(newActiveSpreadsheet)

Устанавливает активную электронную таблицу. 

// The code below makes the spreadsheet with key "1234567890" the active spreadsheet
var ss = SpreadsheetApp.openById("1234567890");
SpreadsheetApp.setActiveSpreadsheet(ss);

Параметры

Имя Тип Описание
newActiveSpreadsheet Spreadsheet Таблица, которую необходимо сделать активной.

setCurrentCell(cell)

Устанавливает указанную ячейку в качестве current cell .

Если указанная ячейка присутствует в уже выбранном диапазоне, то этот диапазон становится активным диапазоном, а ячейка — текущей.

Если указанная ячейка отсутствует ни в одном выбранном диапазоне, существующий выбор удаляется, и ячейка становится текущей ячейкой и активным диапазоном.

Примечание. Указанный Range должен состоять из одной ячейки, иначе этот метод выдаст исключение. 

// The code below sets the cell B5 in the first sheet as the current cell.
var cell = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5');
SpreadsheetApp.setCurrentCell(cell);

var selection = SpreadsheetApp.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

Параметры

Имя Тип Описание
cell Range Ячейка, которую необходимо установить в качестве текущей.

Возвращаться

Range — вновь установленная текущая ячейка

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets