Пользователи должны установить и авторизовать надстройку, прежде чем они смогут открыть и использовать ее. Поскольку эти шаги являются первой частью пользовательского опыта надстройки, вам следует понять их, прежде чем приступать к созданию собственных надстроек.
В этом разделе документации описывается, как пользователи могут установить, авторизовать и начать использовать дополнения Google Workspace.
Установить дополнения
Прежде чем использовать надстройку, ее необходимо установить . После установки дополнение становится доступным в хост-приложении Google Workspace, которое оно расширяет.
Вы можете установить опубликованные дополнения из главного приложения Google Workspace или из Google Workspace Marketplace . Администраторы домена также могут устанавливать надстройки от имени своих пользователей из Google Workspace Marketplace. Вы также можете установить неопубликованные надстройки, которые разрабатываете, чтобы протестировать их. Прежде чем вы сможете использовать установленное дополнение в первый раз, вы должны авторизовать его.
Дополнительные сведения см. в разделе Публикация дополнений .
Авторизовать дополнения
После установки дополнения оно становится доступным в хост-приложении Google Workspace, которое оно расширяет. При первой попытке пользователя использовать надстройку ведущее приложение предоставляет ему карту авторизации или диалоговое окно. На этой карточке объясняется, на какие действия надстройке требуется разрешение пользователя, например на доступ к содержимому текущей таблицы Google. Затем пользователь может предоставить эти разрешения и разрешить работу надстройки. Если пользователь отказывает в авторизации надстройки, он не сможет использовать надстройку.
В надстройках редактора используется модель авторизации, отличная от надстроек Google Workspace. Поскольку надстройки редактора работают с файлами Google Диска, модель авторизации редактора определяет различные режимы авторизации, которые возникают при использовании надстроек с отдельными файлами. При разработке надстроек редактора важно понимать различные режимы и то, как надстройка перемещается между ними.
Подробнее см. Авторизация .
Запустить дополнения
После того как вы установили и авторизовали надстройку, вы можете получить к ней доступ и использовать ее в главном приложении, которое она расширяет.
Надстройки Google Workspace представляют собой значок, обозначающий надстройку, в пользовательском интерфейсе рабочего стола или мобильного приложения хост-приложения; пользователи могут запустить или закрыть надстройку, щелкнув этот значок.
Надстройки редактора обычно содержат по крайней мере один пункт меню надстроек редактора, который позволяет пользователям начать использовать надстройку.
Более подробную информацию см. в разделе Запуск надстроек .