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

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

Предварительная версия для разработчиков: доступна в рамках программы Google Workspace Developer Preview Program , которая предоставляет ранний доступ к определенным функциям.

Рекомендации по авторизации

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

Используйте вход в Google

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

Открыть стороннюю страницу входа в новом окне

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

Примечание. Сторонние страницы входа для надстроек Google Meet не имеют тех же требований к реализации, что и надстройки Google Workspace. Вы можете открыть окно входа прямо из приложения iframe. Дополнения Meet также не поддерживают карты входа в надстройки Google Workspace. Однако вам по-прежнему необходимо перенаправлять пользователей для завершения стороннего процесса аутентификации и авторизации в вашей инфраструктуре .

Правильно запрашивайте области действия для Google API

Если ваша надстройка Meet вызывает API Google, вам необходимо предоставить полный список областей OAuth, необходимых вашей надстройке. Это делается на странице конфигурации приложения Google Workspace Marketplace. После добавления этих областей при установке дополнения Meet вашим пользователям будет показано сообщение, в котором сообщается, к каким данным они разрешают доступ вашему приложению.

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

Примечание. В отличие от обычных надстроек Google Workspace, надстройкам Meet не обязательно включать поле oauthScopes в манифест.

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

Рекомендации по техническому обслуживанию

Следующие рекомендации предназначены для написания удобных в обслуживании веб-приложений, но они особенно важны при написании надстроек Meet.

Используйте последнюю версию SDK дополнений Google Meet.

SDK дополнений Meet регулярно обновляется. SDK придерживается семантического управления версиями . Чтобы найти последнюю версию:

• При использовании gstatic : последняя версия SDK содержится в URL-адресе gstatic, указанном в инструкциях по использованию SDK .
• При использовании npm : запустите npm update @googleworkspace/meet-add-ons из каталога, содержащего package.json для веб-сайта, на котором размещено ваше дополнение Meet.

Создайте промежуточный проект Google Cloud.

Как только ваша надстройка Google Meet будет опубликована на Google Workspace Marketplace , любые новые версии вашей надстройки Google Meet мгновенно станут доступны пользователям Meet. Пользователи увидят эти обновления, как только очистят свои кеши или истечет срок их действия. Поэтому мы рекомендуем не вносить изменения на рабочий сайт до тех пор, пока они не будут тщательно протестированы.

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

Чтобы избежать развертывания сразу в рабочей среде, мы рекомендуем создать отдельный проект Google Cloud , который будет опубликован в частном порядке для вашей организации. В этом облачном проекте будут размещены как промежуточные среды, так и среды разработки для вашего дополнения Meet. Доступ к этому облачному проекту должен быть ограничен небольшой командой, которая непосредственно работает над разработкой вашего дополнения.

Чтобы создать эти альтернативные среды для вашей надстройки, вам сначала необходимо разместить альтернативные среды вашего веб-приложения, содержащего вашу надстройку, в принадлежащем вам домене. Затем вы можете создать альтернативные среды для своего дополнения Meet, добавив дополнительные развертывания в свой промежуточный проект Google Cloud. Эти новые развертывания должны иметь манифесты, указывающие на альтернативные среды вашего веб-приложения. Затем мы рекомендуем вам установить каждую дополнительную среду следующим образом:

• Промежуточная версия : опубликуйте промежуточную версию конфиденциально , чтобы любой сотрудник вашей организации мог помочь с тестированием.
• Разработка . Нажмите « Установить» в столбце «Действия» , чтобы установить разрабатываемую версию дополнения Meet только для вашей учетной записи.

Написание тестов

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

• Имитация SDK дополнений Meet, а затем проверка того, что надстройка Meet вызывает функции SDK должным образом.
• Модульное тестирование всех функций вашего дополнения, не связанных с SDK, с использованием предпочитаемой вами среды веб-тестирования.

Лучшие практики взаимодействия с пользователем

Следующие рекомендации помогут сделать надстройку Meet более интуитивно понятной и усовершенствованной.

Управляйте всеми стартовыми состояниями на боковой панели.

Мы настоятельно рекомендуем настраивать дополнение на основе действий пользователя, выполняемых на боковой панели . Это делается путем установки начального состояния совместной работы в JavaScript. Все данные, которые входят в CollaborationStartingState должны быть установлены инициатором надстройки (обычно организатором собрания) на боковой панели. Вы можете думать о первом представлении боковой панели как о форме, которая управляет настройкой вашего дополнения.

Закрывайте боковую панель, когда она не используется

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

Продвигайте дополнение Meet с помощью демонстрации экрана

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