В этом документе содержится информация об авторизации и аутентификации, специфичная для API Google Classroom. Перед прочтением этого документа обязательно ознакомьтесь с общей информацией об аутентификации и авторизации в Google Workspace по ссылке «Узнайте об аутентификации и авторизации» .
Настройте OAuth 2.0 для авторизации.
Настройте экран согласия OAuth и выберите области действия , чтобы определить, какая информация отображается пользователям и рецензентам приложения, а также зарегистрируйте свое приложение, чтобы вы могли опубликовать его позже.
Области действия API для учебных классов
Чтобы определить уровень доступа, предоставляемый вашему приложению, необходимо идентифицировать и объявить области авторизации . Область авторизации — это строка URI OAuth 2.0, содержащая имя приложения Google Workspace, тип данных, к которым оно получает доступ, и уровень доступа. Области авторизации — это запросы вашего приложения на работу с данными Google Workspace, включая данные учетных записей Google пользователей.
При установке вашего приложения пользователю предлагается подтвердить области действия, используемые приложением. Как правило, следует выбирать максимально узкую область действия и избегать запросов на области, которые вашему приложению не требуются. Пользователи охотнее предоставляют доступ к ограниченным, четко описанным областям действия.
API для работы с учебными классами поддерживает следующие области действия:
| Области применения | Значение |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher | Просматривайте, создавайте и обновляйте вложения к запрашиваемому проекту Google Cloud для потоковой передачи материалов в классах, которые вы преподаете в Google Classroom. |
https://www.googleapis.com/auth/classroom.addons.student | Просматривайте и обновляйте вложения к запрашиваемому проекту Google Cloud, чтобы транслировать элементы в Google Classroom. |
https://www.googleapis.com/auth/classroom.announcements | Просматривайте и управляйте объявлениями в Google Classroom. |
https://www.googleapis.com/auth/classroom.announcements.readonly | Просматривайте объявления в Google Classroom. |
https://www.googleapis.com/auth/classroom.courses | Просматривайте, редактируйте, создавайте и безвозвратно удаляйте свои классы в Google Classroom. |
https://www.googleapis.com/auth/classroom.courses.readonly | Просмотрите свои занятия в Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.me | Просматривайте, создавайте и редактируйте учебные материалы, включая задания, вопросы и оценки. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly | Просматривайте свои учебные материалы и оценки в Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.students | Управляйте учебными заданиями и оценками студентов в классах Google Classroom, которые вы ведете, и просматривайте учебные задания и оценки по классам, которыми вы управляете. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly | Просматривайте учебные материалы и оценки учащихся в классах Google Classroom, которые вы преподаете или администрируете. |
https://www.googleapis.com/auth/classroom.courseworkmaterials | Просматривайте, редактируйте и создавайте учебные материалы в Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly | Просмотрите все учебные материалы для ваших занятий в Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly | Просмотрите список ваших опекунов в Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students | Просматривайте и управляйте правами опекунов учащихся в ваших классах Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly | Просмотрите список защитников учащихся в ваших классах Google Classroom. |
https://www.googleapis.com/auth/classroom.profile.emails | Просмотрите адреса электронной почты людей, обучающихся в ваших классах. |
https://www.googleapis.com/auth/classroom.profile.photos | Просмотрите фотографии профилей людей из ваших классов. |
https://www.googleapis.com/auth/classroom.push-notifications | Получайте уведомления о данных из вашего Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters | Управляйте списками учеников в Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters.readonly | Просмотрите списки учеников вашего класса в Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly | Просматривайте свои учебные материалы и оценки в Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly | Просматривайте учебные материалы и оценки учащихся в классах Google Classroom, которые вы преподаете или администрируете. |
https://www.googleapis.com/auth/classroom.topics | Просматривайте, создавайте и редактируйте темы в Google Classroom. |
https://www.googleapis.com/auth/classroom.topics.readonly | Просматривайте темы в Google Classroom. |