Пользовательский интерфейс Класса поддерживает пять типов Классной работы: Задания, Тестовые задания, Вопросы с кратким ответом, Вопросы с несколькими вариантами ответов и Материалы. API Classroom в настоящее время поддерживает три из этих типов, которые известны как CourseWorkType
для API: задания, вопросы с кратким ответом и вопросы с множественным выбором.
Чтобы получить доступ к этой функции, вы можете использовать ресурс CourseWork , который представляет собой задание или вопрос, назначенный учащимся определенного курса, включая любые дополнительные материалы и сведения, такие как срок сдачи или максимальный балл.
Помимо ресурса CourseWork, вы можете управлять выполненными заданиями с помощью ресурса StudentSubmission
. В следующих разделах они описаны более подробно.
Создание заданий
Задания можно создавать только от имени преподавателей курса, а попытка создать задания в курсе от имени учащегося приведет к ошибке 403 PERMISSION_DENIED
. Аналогично, администраторы домена также не могут создавать задания для курсов, которые они не преподают, и попытка сделать это через API также приведет к ошибке 403 PERMISSION_DENIED
.
При создании заданий с помощью метода courses.courseWork.create
вы можете прикреплять ссылки в качестве materials
, как показано в примере кода ниже:
Ява
Питон
Результат включает в себя идентификатор, назначенный сервером, который можно использовать для ссылки на назначение в других запросах API.
Чтобы включить связанные материалы в задание, созданное с помощью Classroom API, используйте ресурс Link , указав целевой URL-адрес. Класс автоматически получает заголовок и миниатюру. API Classroom также изначально поддерживает материалы Google Диска и YouTube, которые аналогичным образом можно включить в ресурс DriveFile или ресурс YouTubeVideo .
Чтобы указать дату выполнения, установите в полях dueDate
и dueTime
соответствующее время в формате UTC. Срок исполнения должен быть в будущем.
Получение заданий и вопросов
Вы можете получить задания и вопросы для студентов и преподавателей соответствующего курса или администратора домена. Чтобы получить конкретное задание или вопрос, используйтеcourses.courseWork.get. Чтобы получить все задания или вопросы (необязательно соответствующие некоторым критериям), используйтеcourses.courseWork.list.
Требуемая область зависит от роли, которую запрашивающий пользователь имеет в курсе. Если пользователь является студентом, используйте одну из следующих областей:
-
https://www.googleapis.com/auth/classroom.coursework.me.readonly
-
https://www.googleapis.com/auth/classroom.coursework.me
Если пользователь является учителем или администратором домена, используйте одну из следующих областей:
-
https://www.googleapis.com/auth/classroom.coursework.students.readonly
-
https://www.googleapis.com/auth/classroom.coursework.students
Наличие разрешения на получение задания или вопроса не подразумевает разрешения на доступ к материалам или метаданным материалов. На практике это означает, что администратор может не видеть название прикрепленного файла на Диске, если он не является участником курса. Если вы хотите предоставить администраторам доступ к файлам пользователей, см. руководство по делегированию на уровне домена .
Управляйте ответами учащихся
Ресурс StudentSubmission
представляет проделанную работу и оценку учащегося за задание или вопрос. Ресурс StudentSubmission
неявно создается для каждого учащегося при создании нового вопроса или задания.
В следующих разделах описаны общие действия по управлению ответами учащихся.
Получить ответы учащихся
Учащиеся могут получать свои собственные материалы, преподаватели могут получать материалы всех учащихся своих курсов, а администраторы домена могут получать все материалы всех учащихся в своем домене. Каждой работе студента присваивается идентификатор; если вы знаете идентификатор, используйте courses.courseWork.studentSubmissions.get
, чтобы получить его.
Используйте метод courses.courseWork.studentSubmissions.list
, чтобы получить ресурсы StudentSubmission
, соответствующие некоторым критериям, как показано в следующем примере:
Ява
Питон
Получите ресурсы StudentSubmission
, принадлежащие конкретному учащемуся, указав параметр userId
, как показано в следующем примере:
Ява
Питон
Студенты идентифицируются по уникальному идентификатору или адресу электронной почты пользователя, возвращаемому Google Admin SDK. Текущий пользователь также может ссылаться на свой собственный идентификатор, используя сокращение "me"
.
Также можно получить работы учащихся по всем заданиям курса. Для этого используйте литерал "-"
в качестве courseWorkId
, как показано в следующем примере:
Ява
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Питон
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
Требуемая область зависит от роли, которую запрашивающий пользователь имеет в курсе. Используйте следующую область, если пользователь является учителем или администратором домена:
-
https://www.googleapis.com/auth/classroom.coursework.students.readonly
-
https://www.googleapis.com/auth/classroom.coursework.students
Используйте следующую область, если пользователь является студентом:
-
https://www.googleapis.com/auth/classroom.coursework.me.readonly
-
https://www.googleapis.com/auth/classroom.coursework.me
Наличие разрешения на получение работ учащихся не подразумевает разрешения на доступ к вложениям или метаданным вложений. На практике это означает, что администратор может не видеть название прикрепленного файла на Диске, если он не является участником курса. Если вы хотите предоставить администраторам доступ к файлам пользователей, см. руководство по делегированию на уровне домена .
Добавление вложений к ответу учащегося
Вы можете прикрепить ссылки к материалам учащихся, прикрепив ресурс Link
, DriveFile
или YouTubeVideo
. Это делается с помощью courses.courseWork.studentSubmissions.modifyAttachments
, как показано в следующем примере:
Ява
Питон
Вложение ссылки определяется целевым URL-адресом; Класс автоматически получит заголовок и миниатюру. Вы можете узнать о других материалах на соответствующих справочных страницах.
StudentSubmission
может быть изменен только преподавателем курса или студентом, которому он принадлежит. Вы можете прикреплять Materials
только в том случае, если CourseWorkType
заявки учащегося имеет значение ASSIGNMENT
.
Требуемая область зависит от роли, которую запрашивающий пользователь имеет в курсе. Используйте следующую область, если пользователь является учителем:
-
https://www.googleapis.com/auth/classroom.coursework.students
Используйте следующую область, если пользователь является студентом:
-
https://www.googleapis.com/auth/classroom.coursework.me