Рекомендации

Улучшите общее впечатление ваших пользователей, следуя этим руководствам по дизайну надстроек.

Общие рекомендации

Вам рекомендуется следовать следующим рекомендациям для всех разрабатываемых вами надстроек.

Определите владельца надстройки перед запуском

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

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

Расширяйте Google Workspace, а не копируйте его

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

Держите рамки узкими

При явном определении областей всегда выбирайте наименее допустимый набор областей. Например, не предоставляйте вашему запросу дополнения полный доступ к календарю пользователя с областью действия https://www.googleapis.com/auth/calendar , если ему нужен только доступ для чтения. Для доступа только для чтения используйте область https://www.googleapis.com/auth/calendar.readonly .

Не полагайтесь слишком сильно на библиотеки

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

Описанная выше задержка применима только к проектам Apps Script, которые используются в качестве серверных библиотек. Вы можете свободно использовать клиентские библиотеки JavaScript, такие как jQuery, не сталкиваясь с этой задержкой.

Рекомендации по использованию надстроек редактора

Следующие рекомендации применимы только к надстройке редактора}.

Размещайте HTML-код интерфейса и клиентский JavaScript в отдельных файлах сценариев.

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

Тщательное тестирование в разных режимах авторизации

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