Google Classroom API

Umożliwia zarządzanie zajęciami, listami uczniów i zaproszeniami w Google Classroom.

Usługa: classroom.googleapis.com

Zalecamy wywołanie tej usługi przy użyciu dostarczonych przez Google bibliotek klienta. Jeśli aplikacja musi wywoływać tę usługę przy użyciu własnych bibliotek, podczas tworzenia żądań interfejsu API należy używać poniższych informacji.

Dokument opisujący

Dokument opisujący to specyfikacja w formacie czytelnym dla komputerów, opisująca interfejsy API REST i sposób ich używania. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. Ta usługa dostarcza następujący dokument opisujący interfejs API:

Punkt końcowy usługi

Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy i wszystkie poniższe identyfikatory URI odnoszą się do niego:

  • https://classroom.googleapis.com

Zasób REST: v1.courses

Metody
checkAddOnCreationEligibility
(deprecated)		 GET /v1/courses/{courseId}:checkAddOnCreationEligibility
Zwraca informację, czy użytkownik może tworzyć załączniki dodatków w danym kursie.
checkGradingPeriodsSetupEligibility
(deprecated)		 GET /v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
Zwraca informację, czy użytkownik może zaktualizować GradingPeriodSettings na danych zajęciach.
create POST /v1/courses
Tworzy kurs.
delete DELETE /v1/courses/{id}
Usuwa kurs.
get GET /v1/courses/{id}
Zwraca kurs.
getGradingPeriodSettings GET /v1/courses/{courseId}/gradingPeriodSettings
Zwraca ustawienia okresu oceniania na kursie.
list GET /v1/courses
Zwraca listę zajęć, które użytkownik wysyłający żądanie może wyświetlić, ograniczoną do tych, które pasują do żądania.
patch PATCH /v1/courses/{id}
Aktualizuje co najmniej jedno pole w kursie.
update PUT /v1/courses/{id}
Aktualizuje zajęcia.
updateGradingPeriodSettings PATCH /v1/courses/{courseId}/gradingPeriodSettings
Aktualizuje ustawienia okresu oceniania kursu.

Zasób REST: v1.courses.aliases

Metody
create POST /v1/courses/{courseId}/aliases
Tworzy alias zajęć.
delete DELETE /v1/courses/{courseId}/aliases/{alias}
Usuwa alias zajęć.
list GET /v1/courses/{courseId}/aliases
Zwraca listę aliasów zajęć.

Zasób REST: v1.courses.announcements

Metody
create POST /v1/courses/{courseId}/announcements
Tworzy ogłoszenie.
delete DELETE /v1/courses/{courseId}/announcements/{id}
Usuwa ogłoszenie.
get GET /v1/courses/{courseId}/announcements/{id}
Zwraca ogłoszenie.
getAddOnContext GET /v1/courses/{courseId}/announcements/{itemId}/addOnContext
Pobiera metadane dodatków do Classroom w kontekście konkretnego posta.
list GET /v1/courses/{courseId}/announcements
Zwraca listę ogłoszeń, które zgłaszający może wyświetlić.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
Modyfikuje tryb i opcje przypisanej osoby w ogłoszeniu.
patch PATCH /v1/courses/{courseId}/announcements/{id}
Aktualizuje co najmniej jedno pole ogłoszenia.

Zasób REST: v1.courses.announcements.addOnAttachments

Metody
create POST /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
Tworzy załącznik dodatku pod postem.
delete DELETE /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
Usuwa załącznik dodatku.
get GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
Zwraca załącznik dodatku.
list GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
Zwraca wszystkie załączniki utworzone przez dodatek pod postem.
patch PATCH /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
Aktualizuje załącznik dodatku.

Zasób REST: v1.courses.courseWork

Metody
create POST /v1/courses/{courseId}/courseWork
Tworzy zadania.
delete DELETE /v1/courses/{courseId}/courseWork/{id}
Usuwa zadanie.
get GET /v1/courses/{courseId}/courseWork/{id}
Zwraca zadanie.
getAddOnContext GET /v1/courses/{courseId}/courseWork/{itemId}/addOnContext
Pobiera metadane dodatków do Classroom w kontekście konkretnego posta.
list GET /v1/courses/{courseId}/courseWork
Zwraca listę zadań, które osoba wysyłająca żądanie może wyświetlić.
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
Modyfikuje tryb i opcje przypisanej osoby w materiałach dydaktycznych.
patch PATCH /v1/courses/{courseId}/courseWork/{id}
Aktualizuje co najmniej jedno pole zadania.

Zasób REST: v1.courses.courseWork.addOnAttachments

Metody
create POST /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
Tworzy załącznik dodatku pod postem.
delete DELETE /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
Usuwa załącznik dodatku.
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
Zwraca załącznik dodatku.
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
Zwraca wszystkie załączniki utworzone przez dodatek pod postem.
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
Aktualizuje załącznik dodatku.

Zasób REST: v1.courses.courseWork.addOnAttachments.studentSubmissions

Metody
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Zwraca zadanie przesłane przez ucznia w załączniku dodatku.
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions
Zwraca listę zadań przesłanych przez uczniów, które osoba wysyłająca prośbę może wyświetlić.
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Aktualizuje dane powiązane z zadaniem z załącznika dodatku.

Zasób REST: v1.courses.courseWork.rubrics

Metody
create POST /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
Tworzy ocenę cząstkową.
delete DELETE /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Usuwa ocenę cząstkową.
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Zwraca ocenę cząstkową.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
Zwraca listę kryteriów oceny, które zgłaszający może wyświetlić.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
Aktualizuje ocenę cząstkową.

Zasób REST: v1.courses.courseWork.studentSubmissions

Metody
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Zwraca zadanie ucznia.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
Zwraca listę prac uczniów, które osoba wysyłająca żądanie może wyświetlić, uwzględniając zakresy OAuth żądania.
modifyAttachments POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
Modyfikuje załączniki zadania przesłanego przez ucznia.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Aktualizuje co najmniej jedno pole zadania ucznia.
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
Zwraca projekt ucznia w imieniu ucznia, który jest jego właścicielem.
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
Zwraca zadanie ucznia.
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
Oddaje zadanie przesłane przez ucznia.

Zasób REST: v1.courses.courseWorkMaterials

Metody
create POST /v1/courses/{courseId}/courseWorkMaterials
Tworzy materiał do zadania.
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{id}
Usuwa materiał do zajęć.
get GET /v1/courses/{courseId}/courseWorkMaterials/{id}
Zwraca materiał do zadania.
getAddOnContext GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext
Pobiera metadane dodatków do Classroom w kontekście konkretnego posta.
list GET /v1/courses/{courseId}/courseWorkMaterials
Zwraca listę materiałów do zajęć, które osoba wysyłająca żądanie może wyświetlić.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
Aktualizuje co najmniej jedno pole materiału do zajęć.

Zasób REST: v1.courses.courseWorkMaterials.addOnAttachments

Metody
create POST /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
Tworzy załącznik dodatku pod postem.
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Usuwa załącznik dodatku.
get GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Zwraca załącznik dodatku.
list GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
Zwraca wszystkie załączniki utworzone przez dodatek pod postem.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Aktualizuje załącznik dodatku.

Zasób REST: v1.courses.posts

Metody
getAddOnContext GET /v1/courses/{courseId}/posts/{postId}/addOnContext
Pobiera metadane dodatków do Classroom w kontekście konkretnego posta.

Zasób REST: v1.courses.posts.addOnAttachments

Metody
create POST /v1/courses/{courseId}/posts/{postId}/addOnAttachments
Tworzy załącznik dodatku pod postem.
delete DELETE /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
Usuwa załącznik dodatku.
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
Zwraca załącznik dodatku.
list GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments
Zwraca wszystkie załączniki utworzone przez dodatek pod postem.
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
Aktualizuje załącznik dodatku.

Zasób REST: v1.courses.posts.addOnAttachments.studentSubmissions

Metody
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Zwraca zadanie przesłane przez ucznia w załączniku dodatku.
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
Aktualizuje dane powiązane z zadaniem z załącznika dodatku.

Zasób REST: v1.courses.studentGroups

Metody
create POST /v1/courses/{courseId}/studentGroups
Tworzy grupę uczniów na zajęciach.
delete DELETE /v1/courses/{courseId}/studentGroups/{id}
Usuwa grupę uczniów.
list GET /v1/courses/{courseId}/studentGroups
Zwraca listę grup na kursie.
patch PATCH /v1/courses/{courseId}/studentGroups/{id}
Aktualizuje co najmniej jedno pole w grupie uczniów.

Zasób REST: v1.courses.studentGroups.studentGroupMembers

Metody
create POST /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers
Tworzy członka grupy uczniów w grupie uczniów.
delete DELETE /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers/{userId}
Usuwa członka grupy uczniów.
list GET /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers
Zwraca listę uczniów w grupie.

Zasób REST: v1.courses.students

Metody
create POST /v1/courses/{courseId}/students
Dodaje użytkownika jako ucznia na kursie.
delete DELETE /v1/courses/{courseId}/students/{userId}
Usuwa ucznia z zajęć.
get GET /v1/courses/{courseId}/students/{userId}
Zwraca ucznia na zajęciach.
list GET /v1/courses/{courseId}/students
Zwraca listę uczniów na tych zajęciach, których osoba wysyłająca żądanie może wyświetlić.

Zasób REST: v1.courses.teachers

Metody
create POST /v1/courses/{courseId}/teachers
Tworzy nauczyciela kursu.
delete DELETE /v1/courses/{courseId}/teachers/{userId}
Usuwa określonego nauczyciela z określonych zajęć.
get GET /v1/courses/{courseId}/teachers/{userId}
Zwraca nauczyciela zajęć.
list GET /v1/courses/{courseId}/teachers
Zwraca listę nauczycieli tych zajęć, których osoba wysyłająca żądanie może wyświetlić.

Zasób REST: v1.courses.topics

Metody
create POST /v1/courses/{courseId}/topics
Tworzy temat.
delete DELETE /v1/courses/{courseId}/topics/{id}
Usuwa temat.
get GET /v1/courses/{courseId}/topics/{id}
Zwraca temat.
list GET /v1/courses/{courseId}/topics
Zwraca listę tematów, które użytkownik wysyłający żądanie może wyświetlić.
patch PATCH /v1/courses/{courseId}/topics/{id}
Aktualizuje co najmniej jedno pole tematu.

Zasób REST: v1.invitations

Metody
accept POST /v1/invitations/{id}:accept
Akceptuje zaproszenie, usuwając je i dodając zaproszonego użytkownika do nauczycieli lub uczniów (odpowiednio) określonych zajęć.
create POST /v1/invitations
Tworzy zaproszenie.
delete DELETE /v1/invitations/{id}
Usuwa zaproszenie.
get GET /v1/invitations/{id}
Zwraca zaproszenie.
list GET /v1/invitations
Zwraca listę zaproszeń, które użytkownik wysyłający żądanie może wyświetlić, ograniczoną do tych, które pasują do żądania listy.

Zasób REST: v1.registrations

Metody
create POST /v1/registrations
Tworzy Registration, co powoduje, że Classroom zaczyna wysyłać powiadomienia z podanego feed do miejsca docelowego podanego w cloudPubSubTopic.
delete DELETE /v1/registrations/{registrationId}
Usuwa Registration, co powoduje, że Classroom przestaje wysyłać powiadomienia dotyczące tego Registration.

Zasób REST: v1.userProfiles

Metody
checkUserCapability GET /v1/userProfiles/{userId}:checkUserCapability
Zwraca informację, czy użytkownik może korzystać z określonej funkcji Classroom.
get GET /v1/userProfiles/{userId}
Zwraca profil użytkownika.

Zasób REST: v1.userProfiles.guardianInvitations

Metody
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations
Tworzy zaproszenie dla opiekuna i wysyła do niego e-maila z prośbą o potwierdzenie, że jest opiekunem ucznia.
get GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Zwraca określone zaproszenie dla opiekuna.
list GET /v1/userProfiles/{studentId}/guardianInvitations
Zwraca listę zaproszeń dla opiekunów, które użytkownik wysyłający żądanie może wyświetlić, przefiltrowaną według podanych parametrów.
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Modyfikuje zaproszenie dla opiekuna.

Zasób REST: v1.userProfiles.guardians

Metody
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId}
Usuwa opiekuna.
get GET /v1/userProfiles/{studentId}/guardians/{guardianId}
Zwraca określonego opiekuna.
list GET /v1/userProfiles/{studentId}/guardians
Zwraca listę opiekunów, których użytkownik wysyłający żądanie może wyświetlić, ograniczoną do tych, którzy pasują do żądania.