Поскольку вход в систему — это первое взаимодействие пользователя с вашим дополнением, важно, чтобы он мог пройти весь процесс максимально гладко. Ознакомьтесь с разделами ниже, чтобы ознакомиться с различными API для входа, параметрами запросов, связанными со входом, способами работы с блокировщиками всплывающих окон и планом тестирования, который можно использовать во время разработки, чтобы убедиться в соблюдении передовых практик.
Подробности реализации единого входа
OAuth 2.0 от Google совместим со многими стеками OAuth 2.0. Мы настоятельно рекомендуем реализовать авторизацию на стороне сервера, поскольку это самый безопасный вариант, поддерживающий использование параметров запроса iframe .
При внедрении входа через Google Identity ознакомьтесь с техническими рекомендациями на сайте Google Identity. Обязательно следуйте рекомендациям по брендингу входа через Google. Доступны для загрузки файлы Sketch, SVG и EPS.
Тесты входа
Используйте план тестирования надстроек, чтобы убедиться, что ваша надстройка соответствует требуемым стандартам и способна обрабатывать известные пограничные случаи, прежде чем отправлять её на проверку. Эти тесты точно соответствуют контрольному списку требований к надстройкам для класса и содержат пошаговые инструкции по проверке соответствия вашей надстройки этим требованиям. Это те же тесты, с помощью которых ваше приложение тестируется при публикации.
Параметры запроса входа
Google Classroom предоставляет параметр запроса login_hint для упрощения повторного входа. Дополнительную информацию см. в разделе «Параметры входа» на странице параметров запроса iframe. Пример кода можно найти в пошаговом руководстве по обработке повторных посещений в наших руководствах для разработчиков.
Управление блокировщиками всплывающих окон
Вход в дополнение упрощается благодаря диалоговому окну входа. В этом окне отображается экран выбора учётной записи, позволяющий пользователю предоставить разрешения OAuth. Блокировщик всплывающих окон, установленный пользователем, может помешать ему завершить процесс входа.
Рисунок 1. Пример экрана выбора учетной записи .
Чтобы решить эту проблему, предоставьте конечному пользователю кнопку, нажатие которой позволит обойти блокировщик всплывающих окон. Это взаимодействие позволит отобразить диалоговое окно входа, чтобы конечный пользователь мог продолжить процесс входа. Убедитесь, что предоставляемая вами кнопка соответствует правилам брендинга входа .
Следуйте пошаговому руководству по входу в систему из наших пошаговых руководств для разработчиков, чтобы реализовать фирменную кнопку входа Google, при нажатии на которую открывается диалоговое окно входа.
Мультилогин
Браузер с несколькими аккаунтами, вошедшими в систему одновременно, может нарушить работу пользователя с дополнением. Пользователи могут либо выйти из всех аккаунтов Google в текущем браузере , либо открыть Класс в режиме инкогнито в окне Chrome, прежде чем войти в нужную учётную запись и повторить операцию.
Если из-за проблемы с множественным входом в дополнение вошёл не тот пользователь, ваши вызовы API дополнений «Класс» могут завершиться ошибкой InvalidAddOnToken . При возникновении такой ошибки следует попросить пользователя либо выйти из всех остальных учётных записей в браузере, либо открыть «Класс» в окне Chrome в режиме инкогнито.