Пользовательское меню в Документах, Таблицах и Формах

Google Apps Script умеет создавать меню, содержание которого определяет разработчик. Меню может быть создано для приложений Таблиц, Документы или Формы (режим редактирования). Отличительной особенностью является то, что нельзя передать параметры в вызываемую через меню функцию.
Принцип построения меню будет всегда одинаковый:

1. Необходимо получить экземпляр среды пользовательского интерфейса Ui, позволяющий скрипту добавлять такие функции, как меню, диалоговые окна, боковые панели.
2. Создать объект меню createMenu().
3. Наполнить меню возможными элементами: пунктами меню addItem(), подменю addSubMenu(), разделителями addSeparator().
4. Добавить меню в интерфейс, вызвав метод addToUi()

Для того, чтобы меню появлялось сразу после открытия файла, необходимо добавить функцию создания меню в простой триггер onOpen().

1. Пример простого приложения для Формы

	function onOpen(){
	FormApp.getUi().createMenu("Моё меню")
	.addItem("Добавить текстовое поле", "addTextField")
	.addItem("Об этой Форме", "aboutForm")
	.addToUi();
	}
	function addTextField(){
	var textField = FormApp.getActiveForm().addTextItem();
	textField.setTitle("Новое текстовое поле");
	textField.setHelpText("Дополнительный текст");
	}
	function aboutForm(){
	var dic = [
	{
	"title": "Это тест",
	"cmd": "isQuiz",
	"val": undefined
	},
	{
	"title": "Принимает ответы",
	"cmd": "isAcceptingResponses",
	"val": undefined
	},
	{
	"title": "Сводка ответов опубликована",
	"cmd": "isPublishingSummary",
	"val": undefined
	}
	];
	var message = "";
	var form = FormApp.getActiveForm();
	for(var i = 0; i < dic.length; i++){
	message += dic[i].title + ": " + form[dic[i].cmd]() + "\n";
	}
	FormApp.getUi().alert(message);
	}

view raw 1. Пример простого приложения для Формы.gs hosted with ❤ by GitHub

Создает пользовательское меню

Содержимое меню

Добавление текстового поля

Отчет о Форме

2. Пример простого приложения для Таблиц

	function onOpen(){
	SpreadsheetApp.getUi().createMenu("Моё меню")
	.addItem("Добавить новый лист", "addNewSheet")
	.addToUi();
	}
	function addNewSheet(){
	SpreadsheetApp.getActive().insertSheet();
	}

view raw 2. Пример простого приложения для Таблиц.gs hosted with ❤ by GitHub

3. Пример простого приложения для Документов

	function onOpen(){
	DocumentApp.getUi().createMenu("Моё меню")
	.addItem("Добавить новый абзац", "addNewParagraph")
	.addToUi();
	}
	function addNewParagraph(){
	DocumentApp.getActiveDocument().getBody().appendParagraph("Новый абзац");
	}

view raw 3. Пример простого приложения для Документов.gs hosted with ❤ by GitHub

Ссылки

• Custom Menus in G Suite