Доступ и создание файлов 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. |
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
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