Перед созданием дополнения для редактора ознакомьтесь с квотами и ограничениями Apps Script, чтобы убедиться, что ваш проект соответствует этим рекомендациям. Ознакомление с этими ограничениями на ранних этапах разработки поможет предотвратить потенциальные проблемы в дальнейшем. Apps Script идеально подходит для разработки лёгких дополнений для себя, своей команды или организации. Однако, если вы планируете создать крупномасштабное дополнение, которое должно обслуживать множество пользователей, требовать низкой задержки или полного контроля над инфраструктурой, рассмотрите возможность разработки дополнения Google Workspace в другой среде выполнения .
При создании надстройки Editor следуйте этой общей процедуре:
- Создайте проект Apps Script.
- Напишите код, определяющий внешний вид и поведение дополнения, используя встроенную службу Apps Script HTML .
- Протестируйте дополнение.
- Опубликуйте дополнение.
Создать сценарий проекта
Надстройка редактора — это отдельный проект Apps Script. Руководство по отдельному скрипту содержит инструкции по созданию новых проектов . Вы также можете просто открыть новый скрипт . В этом случае файл проекта (первоначально называемый Untitled project ) будет помещен в корневую папку вашего Диска.
Сотрудничество
При совместной разработке дополнения проектом дополнения владеет одна учётная запись пользователя. При публикации дополнения одна учётная запись пользователя выступает в роли издателя. Учётная запись, публикующая дополнение, должна иметь право на редактирование проекта скрипта дополнения, но не обязательно должна быть владельцем проекта.
Очень важно избегать ситуаций, когда вы теряете доступ к коду или настройкам дополнения из-за того, что владелец проекта покинул вашу организацию.
Чтобы не потерять доступ к коду дополнения, мы рекомендуем использовать общие диски при совместной работе над дополнением. Размещение файла скрипта дополнения на общем диске гарантирует, что ни одна учётная запись не будет единственным владельцем проекта.
Также рекомендуется добавить соавторов в проект облачной платформы (GCP) скрипта . Это поможет гарантировать, что кто-то из вашей команды всегда будет иметь доступ к настройкам облачной платформы надстройки.
Код дополнения
После создания проекта скрипта можно приступить к написанию кода, определяющего внешний вид и поведение дополнения. Для создания пользовательского интерфейса дополнения — диалоговых окон и боковых панелей — используется сервис Apps Script HtmlService с использованием обычного HTML и CSS. Дополнения-редакторы также могут определять пользовательские пункты меню .
При написании кода обратитесь к руководству по стилю надстроек редактора, чтобы узнать, как создать пользовательский интерфейс надстройки. Кроме того, убедитесь, что вы понимаете и учитываете различные состояния жизненного цикла авторизации, с которыми может столкнуться ваша надстройка.
Протестируйте дополнение
Вы можете протестировать надстройки Редактора перед их публикацией, чтобы убедиться в их корректной работе. Для тестирования необходимо создать тестовую конфигурацию и использовать тестовый документ, электронную таблицу, форму или презентацию.
Подробности смотрите в разделе Тестирование дополнения «Редактор» .
Опубликовать дополнение
Публикация дополнения делает его доступным для других пользователей, как публично, так и только для пользователей вашего домена. Перед началом процесса публикации обязательно ознакомьтесь с обзором публикации .
Дополнения для редактора публикуются в Google Workspace Marketplace . Публично доступные дополнения должны пройти проверку перед публикацией.
Более подробную информацию см. в разделе Публикация дополнения «Редактор» .