Aplikacja Classroom obsługuje 3 typy elementów strumienia: CourseWork
, CourseWorkMaterials
i Announcements
. Ten przewodnik opisuje, jak zarządzać CourseWork
, ale interfejsy API wszystkich elementów strumienia są podobne. Więcej informacji o typach elementów strumienia i ich różnicach znajdziesz w sekcji Zasoby interfejsu API.
CourseWork
reprezentuje element pracy przypisany do uczniów na konkretnym kursie, w tym wszelkie dodatkowe materiały i szczegóły, takie jak termin lub maksymalna liczba punktów. Istnieją 4 podtypy CourseWork
: projekty, projekty – testy, pytania z krótką odpowiedzią i pytania wielokrotnego wyboru. Interfejs Classroom API obsługuje 3 z tych podtypów: projekty, pytania z krótką odpowiedzią i pytania jednokrotnego wyboru. Te typy są reprezentowane przez pole CourseWork.workType
.
Oprócz zasobu CourseWork
możesz zarządzać ukończoną pracą za pomocą zasobu StudentSubmission
.
Tworzenie zadania
CourseWork
można utworzyć tylko w imieniu nauczyciela kursu. Próba utworzenia CourseWork
w imieniu ucznia lub administratora domeny, który nie jest nauczycielem na kursie, powoduje błąd PERMISSION_DENIED
. Więcej informacji o różnych rolach w Classroom znajdziesz w artykule Typy użytkowników.
Podczas tworzenia CourseWork
za pomocą metody courses.courseWork.create
możesz dołączać linki jako materials
, jak pokazano w poniższym przykładowym kodzie:
Java
Python
Pola title
i workType
są wymagane. Wszystkie pozostałe pola są opcjonalne. Jeśli nie podasz wartości state
, element CourseWork
zostanie utworzony w stanie wersji roboczej.
Użyj zasobu Link z określonym celem url
, aby uwzględnić połączone materiały w CourseWork
. Classroom automatycznie pobiera title
i adres URL obrazu miniatury (thumbnailUrl
). Interfejs Classroom API natywnie obsługuje też materiały z Dysku Google i YouTube, które można dołączyć w podobny sposób za pomocą zasobu DriveFile lub zasobu YouTubeVideo.
Aby określić termin, ustaw pola dueDate
i dueTime
na odpowiedni czas UTC. Termin musi przypadać w przyszłości.
Odpowiedź CourseWork
zawiera identyfikator przypisany przez serwer, którego można używać do odwoływania się do przypisania w innych żądaniach API.
Pobieranie zadania
Możesz pobrać CourseWork
w imieniu uczniów i nauczycieli odpowiedniego kursu. Możesz też pobierać CourseWork
w imieniu administratorów domeny, nawet jeśli nie są nauczycielami na zajęciach. Aby pobrać konkretny CourseWork
, użyj courses.courseWork.get
. Aby pobrać wszystkie elementyCourseWork
(opcjonalnie pasujące do określonych kryteriów), użyjcourses.courseWork.list
.
Wymagany zakres zależy od roli użytkownika wysyłającego żądanie w kursie. Jeśli użytkownik jest uczniem, użyj jednego z tych zakresów:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
Jeśli użytkownik jest nauczycielem lub administratorem domeny, użyj jednego z tych zakresów:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Posiadanie uprawnień do pobierania CourseWork
nie oznacza uprawnień do dostępu do materiałów ani metadanych materiałów. W praktyce oznacza to, że administrator może nie widzieć tytułu załączonego pliku na Dysku, jeśli nie jest użytkownikiem zajęć.
Zarządzanie odpowiedziami uczniów
Zasób StudentSubmission
reprezentuje pracę wykonaną przez ucznia w ramach CourseWork
. Zasób zawiera metadane związane z pracą, takie jak stan pracy i ocena. Dla każdego ucznia jest automatycznie tworzony StudentSubmission
, gdy tworzony jest nowy CourseWork
.
W sekcjach poniżej znajdziesz opis typowych działań związanych z zarządzaniem odpowiedziami uczniów.
Pobieranie odpowiedzi uczniów
Uczniowie mogą pobierać własne przesłane projekty, nauczyciele mogą pobierać przesłane projekty wszystkich uczniów na swoich kursach, a administratorzy domeny mogą pobierać wszystkie przesłane projekty wszystkich uczniów w domenie. Każdemu StudentSubmission
przypisywany jest identyfikator. Jeśli znasz identyfikator, użyj courses.courseWork.studentSubmissions.get
, aby pobrać zgłoszenie.
Użyj metody courses.courseWork.studentSubmissions.list
, aby pobrać wszystkie zasoby StudentSubmission
, które spełniają określone kryteria, jak pokazano w tym przykładzie:
Java
Python
Pobierz zasoby StudentSubmission
należące do konkretnego ucznia, podając parametr userId
, jak pokazano w tym przykładzie:
Java
Python
Uczniowie są identyfikowani na podstawie unikalnego identyfikatora lub adresu e-mail, jak to przedstawiono w zasobie Student
. Bieżący użytkownik może też odwoływać się do własnego identyfikatora za pomocą skrótu "me"
.
Możesz też pobrać przesłane przez uczniów projekty ze wszystkich projektów w ramach kursu. W tym celu użyj literału "-"
jako courseWorkId
, jak pokazujemy w tym przykładzie:
Java
service.courses().courseWork().studentSubmissions() .list(courseId, "-") .set("userId", userId) .execute();
Python
service.courses().courseWork().studentSubmissions().list( courseId=<course ID or alias>, courseWorkId='-', userId=<user ID>).execute()
Wymagany zakres zależy od roli użytkownika wysyłającego żądanie w kursie. Jeśli użytkownik jest nauczycielem lub administratorem domeny, użyj tego zakresu:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Jeśli użytkownik jest uczniem, użyj tego zakresu:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
Uprawnienie do pobierania StudentSubmission
nie oznacza uprawnień do dostępu do załączników ani metadanych załączników. W praktyce oznacza to, że administrator może nie widzieć tytułu załączonego pliku na Dysku, jeśli nie jest użytkownikiem zajęć.
Dodawanie załączników do odpowiedzi ucznia
Możesz dołączyć linki do przesłanego przez ucznia zadania, dodając zasób Link
, DriveFile
lub YouTubeVideo
. Możesz to zrobić za pomocą elementu courses.courseWork.studentSubmissions.modifyAttachments
, jak pokazano w tym przykładzie:
Java
Python
Link
załącznik jest określany przez element docelowy url
; Classroom automatycznie pobiera title
i miniaturę (thumbnailUrl
). Więcej informacji o materiałach, które można dołączyć do StudentSubmissions
, znajdziesz w artykule Material
.
StudentSubmission
może modyfikować tylko nauczyciel prowadzący kurs lub uczeń, który jest jego właścicielem. Możesz dołączyć Materials
tylko wtedy, gdy CourseWorkType
StudentSubmission
ma wartość ASSIGNMENT
.
Wymagany zakres zależy od roli użytkownika wysyłającego żądanie w kursie. Jeśli użytkownik jest nauczycielem, użyj tego zakresu:
https://www.googleapis.com/auth/classroom.coursework.students
Jeśli użytkownik jest uczniem, użyj tego zakresu:
https://www.googleapis.com/auth/classroom.coursework.me