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

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

Передовые методы авторизации

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

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

Многие пользователи надстроек Google Workspace уже авторизовались в Google перед подключением к собранию. Поэтому наличие опции Google One Tap может сэкономить пользователям несколько кликов при прохождении процедуры авторизации. Для получения дополнительной информации см. раздел «Управление методами авторизации для вашей надстройки» .

Откройте страницу авторизации стороннего сервиса в новом окне.

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

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

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

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

При написании кода для вызова API Google Workspace проще всего начать работу, следуя инструкциям из руководства по быстрому запуску JavaScript . Этот подход соответствует лучшим практикам использования Google Sign-In и диалоговых окон. Обратите внимание, что инициализация клиента токена в JavaScript требует отдельного запроса областей действия (scopes), которые приложение фактически использует во время выполнения. Для наилучшего пользовательского опыта запрошенные области действия должны совпадать с областями действия на странице конфигурации приложения 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 , все новые версии вашего дополнения мгновенно становятся доступны пользователям Meet. Пользователи увидят эти обновления, как только очистят свой кэш или истечет срок его действия. Поэтому мы рекомендуем не вносить изменения на ваш рабочий сайт до тех пор, пока они не будут тщательно протестированы.

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

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

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

Напишите тесты

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

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

лучшие практики пользовательского опыта

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

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

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

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

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

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

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

Рекомендации по дизайну логотипа

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

Используйте файл в формате PNG размером 256 x 256 пикселей.

Используйте прозрачность.

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

Убедитесь, что ваш логотип (и другие графические элементы ) хорошо выглядят в режиме высокой контрастности, используя инструмент проверки контрастности, например, Contrast Checker от Web Accessibility In Mind (WebAIM).

Необходимо соблюдать графические требования для интеграции конкретных приложений .

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