Google Apps Script: основные команды для автоматизации Гугл Таблиц
Навигация по классу SpreadsheetApp.
Spreadsheet (таблица как документ)
SpreadsheetApp.openByUrl (url)
SpreadsheetApp.openById (id)
SpreadsheetApp.getActive()
SpreadsheetApp.getActiveSpreadsheet()
SpreadsheetApp.open(file)
Вспомогательные функции:
ss.getUrl() ss.getId()
ss.getName() ss.getFormUrl()
Основные команды:
Создать
Spreadsheet (таблица как документ)
SpreadsheetApp.create (name)
Вставить лист
ss.insertSheet ( )
ss.insertSheet ( sheetIndex )
ss.insertSheet ( sheetName )
ss.insertSheet ( sheetName, sheetIndex )
Добавить строку с контентом
sheet.appendRow(rowContent)
Переименовать ss.rename ( name )
Удалить
Лист
ss.duplicateActiveSheet ( )
sheet.copyToSpreadsheet ( spreadsheet )
Удалить строки и столбцы
Одну строку sheet.deleteRow(rowPosition)
Несколько:sheet.deleteRows(rowPosition, howMany)
Один столбец:
sheet.deleteColumn(columnPosition)
Несколько столбцов:
sheet.deleteColumns (columnPosition,howMany)
Диапазон ячеек range.deleteCells (shiftDimension)
© проект «Автоматизация без обязательств» 2021
Range (диапазон) Cell (ячейка) Триггеры
Sheet (лист) getRange getRange(row, Простые триггеры (на редактирование, пример)
ss.getSheetByName(name) (row,column,numRows,numColumns) column) function onEdit(e) {
ss.getActiveSheet() getRange ( a1Notation ) getRange(a1Notation) var range = e.range,
getActiveRange() getCurrentCell ( ) row = range.getRow(),
Вспомогательные функции: getRange (row, column, numRows) getActiveCell ( ) column = range.getColumn();
sheet.getName() =sheet.getSheetName() Вспомогательные функции: range.offset(0, 1).setValue(new Date().toLocaleString('ru'))}
sheet.getSheetId() range.getSheet() range.getA1Notation() range.getRow() range.getColumn() Перечень объектов: e.range,e.value,e.sourse
Получить все листы sheet.getLastRow() sheet.getLastColumn() Простые триггеры (на открытие, пример
таблицы: ss.getSheets() range.getNumRows() range.getNumColumns() "Создание пользовательского меню")
sheet.getIndex() sheet.getFormUrl() range.offset(rowOffset, columnOffset)
function onOpen() {
var ui = SpreadsheetApp.getUi();
ссылка на официальную документацию по Google Apps Script
ui.createMenu('МОЁ МЕНЮ')
.addItem('Запустить функцию 1', 'myFunction1')
.addToUi();}
Вставить строки
Копировать
sheet.insertRowBefore ( beforePosition ) Кнопки
sheet.insertRowAfter ( afterPosition ) Spreadsheet (таблица как документ)
sheet.insertRows ( rowIndex ) Вставка → Изображение → Изображение поверх ячеек
ss.copy ( name) или Вставка → Рисунок (нарисовать любую фигуру)
sheet.insertRows ( rowIndex, numRows ) дальше одинаково:
sheet.insertRowsBefore(beforePosition,howMany) Лист • • • → Назначить скрипт → Вписать название функции без ( )
sheet.insertRowsAfter ( afterPosition, howMany )
ss.duplicateActiveSheet() Управление триггерами вручную
Вставить столбцы sheet.copyToSpreadsheet(spreadsheet ) Проект Apps Script → Слева "Триггеры" →
sheet.insertColumnBefore(beforePosition) В правом нижнем углу нажмите Добавить триггер →
Добавить строку с контентом
sheet.insertColumnAfter(afterPosition) Выберите и настройте тип триггера → Сохранить
sheet.insertColumns(columnIndex) range.copyTo ( destination ) Программное управление триггерами
sheet.insertColumns(columnIndex,numColumns) range.copyTo(destination,copyPasteType,
sheet.insertColumnsBefore(beforePosition,howMany) transposed) function createTimeDrivenTrigger() {
sheet.insertColumnsAfter(afterPosition,howMany) range.copyTo ( destination, options ) ScriptApp.newTrigger('myFunction')
.timeBased() .onWeekDay(ScriptApp.WeekDay.MONDAY)
.atHour(9) .create();}
Таблицу Лист Получить/установить значение
sheet.setName ( name ) getValue() - setValue()
Пользовательские функции (пример)
getValues() - setValues()
function kilometersToNauticalMiles ( kilometers ) {
range.getNote - range.setNote (примечания)
var nauticalMiles = kilometers/1.8522;
Очистить activate () - активировать
return nauticalMiles }
Лист
Скрипт можно записать с помощью макроса: Инструменты → Макросы → Запись макроса
sheet.clear ( )
sheet.clearContents ( )
sheet.clearFormats ( ) ДРУГИЕ ПОЛЕЗНЫЕ ФУНКЦИИ:
sheet.clearNotes ( ) Отправить письмо: MailApp.sendEmail(recipient, subject, body)
sheet.clearConditionalFormatRules() Отправить событие в календарь: CalendarApp.getCalendarById("ID").createEvent(title, startTime, endTime)
Поисковый запрос: ss.createTextFinder(findText).findNext()
Диапазон
Перевести текст: LanguageApp.translate(text, sourceLanguage, targetLanguage)
range.clear ( ) range.clearContent ( ) Вывести окно с сообщением:SpreadsheetApp.getUi().alert('message')
range.clearFormat ( ) Получить email пользователя сессии: Session.getActiveUser().getEmail()
Получить текущую дату и время: new Date().toLocaleString('ru')
range.clearNote ( )
Узнать, что в переменной: Logger.log ('переменная: '+ х + ', тип: '+ typeof х)
range.clearDataValidations ( )