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

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

Общие передовые методы

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

Определите права собственности на дополнение перед началом работы.

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

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

Расширяйте возможности Google Workspace, а не дублируйте их.

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

Держите прицел узким.

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

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

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

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

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

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

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

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

Проведите тщательное тестирование в различных режимах авторизации.

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