Дополнения редактора зданий

Следуйте этой общей процедуре при создании надстройки редактора:

  1. Создайте проект скрипта приложений.
  2. Напишите код, определяющий внешний вид и поведение надстройки, используя встроенный HTML-сервис Apps Script.
  3. Протестируйте дополнение.
  4. Опубликуйте дополнение.

Создать проект сценария

Надстройка редактора — это отдельный проект Apps Script. Руководство по автономным сценариям содержит инструкции по созданию новых проектов . Вы также можете просто открыть новый скрипт . Если вы это сделаете, файл проекта (первоначально названный Untitled project ») будет помещен в корневую папку вашего Диска.

Сотрудничество

Когда вы сотрудничаете с другими пользователями в разработке надстройки, проект надстройки принадлежит одной учетной записи пользователя. Когда вы публикуете надстройку, одна учетная запись пользователя выступает в качестве издателя. У учетной записи публикации должен быть доступ к редактированию проекта сценария надстройки, но он не обязательно должен быть владельцем проекта.

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

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

Также рекомендуется добавить соавторов в проект Cloud Platform (GCP) проекта скрипта . Это помогает гарантировать, что кто-то из вашей команды всегда сможет получить доступ к настройкам облака надстройки.

Закодируйте дополнение

После создания проекта сценария вы можете приступить к написанию кода, определяющего внешний вид и поведение надстройки. Служба Apps Script HtmlService используется для создания дополнительного пользовательского интерфейса — диалоговых окон и боковых панелей — с использованием обычного HTML и CSS. Надстройки редактора также могут определять пользовательские пункты меню .

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

Протестируйте дополнение

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

Подробности см. в разделе «Проверка надстройки редактора» .

Опубликовать дополнение

Публикация вашего дополнения делает его доступным для других, как публично, так и только пользователей в вашем домене. Прежде чем приступить к процессу публикации, обязательно ознакомьтесь с обзором публикации .

Дополнения редактора публикуются в Google Workspace Marketplace . Общедоступные дополнения должны пройти проверку перед публикацией.

Дополнительную информацию см. в разделе Публикация надстройки редактора .