Ten dokument zawiera szczegółowe informacje na temat autoryzacji i uwierzytelniania dotyczące interfejsu Google Classroom API. Zanim przeczytasz ten dokument, zapoznaj się z ogólnymi informacjami o uwierzytelniania i autoryzacji w Google Workspace w artykule Więcej informacji o uwierzytelnianiu i autoryzacji.
Konfigurowanie protokołu OAuth 2.0 na potrzeby autoryzacji
Skonfiguruj ekran zgody OAuth i wybierz zakresy, aby określić, jakie informacje będą widoczne dla użytkowników i weryfikatorów aplikacji, oraz zarejestrować aplikację, aby móc ją później opublikować.
Zakresy interfejsów API Classroom
Aby określić poziom dostępu przyznany aplikacji, musisz wskazać i zadeklarować zakresy autoryzacji. Zakres autoryzacji to ciąg identyfikatora URI OAuth 2.0 zawierający nazwę aplikacji Google Workspace, rodzaj danych, do których aplikacja ma dostęp, oraz poziom dostępu. Zakresy to żądania aplikacji dotyczące pracy z danymi Google Workspace, w tym danymi kont Google użytkowników.
Po zainstalowaniu aplikacji użytkownik jest proszony o sprawdzenie zakresów używanych przez aplikację. Warto wybrać najwęższy możliwy zakres i unikać żądania zakresów, które nie są wymagane przez aplikację. Użytkownicy łatwiej przyznają dostęp do ograniczonych, jasno opisanych zakresów.
Interfejs Classroom API obsługuje te zakresy:
| Zakresy | Znaczenie |
|---|---|
https://www.googleapis.com/auth/classroom.announcements
|
Wyświetlanie ogłoszeń w Google Classroom i zarządzanie nimi. |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Wyświetlanie ogłoszeń w Google Classroom. |
https://www.googleapis.com/auth/classroom.courses
|
Wyświetlanie, edytowanie, tworzenie i trwałe usuwanie zajęć w Google Classroom. |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Wyświetlanie zajęć w Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Wyświetlanie, tworzenie i edytowanie elementów zadań, w tym projektów, pytań i ocen. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Wyświetlanie zadań i ocen w Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Zarządzanie zadaniami i ocenami uczniów na Twoich zajęciach w Google Classroom oraz wyświetlanie zadań i ocen na zajęciach, którymi zarządzasz. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Wyświetlanie zadań i ocen uczniów na zajęciach, na których uczysz lub którymi zarządzasz, w Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Wyświetlanie, edytowanie i tworzenie materiałów do zadań w Google Classroom. |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Zobacz wszystkie materiały do zadań na zajęcia w Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Wyświetlanie opiekunów w Google Classroom. |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Wyświetlanie opiekunów uczniów na zajęciach w Google Classroom i zarządzanie nimi. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Wyświetlanie opiekunów uczniów na zajęciach w Google Classroom. |
https://www.googleapis.com/auth/classroom.profile.emails
|
Wyświetlanie adresów e-mail osób z Twoich zajęć. |
https://www.googleapis.com/auth/classroom.profile.photos
|
wyświetlać zdjęcia profilowe osób z Twoich zajęć, |
https://www.googleapis.com/auth/classroom.push-notifications
|
Otrzymuj powiadomienia dotyczące Twoich danych w Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters
|
Zarządzaj rozkładami zajęć w Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Wyświetlanie rozkładów zajęć w Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Wyświetlanie zadań i ocen w Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Wyświetlanie zadań i ocen uczniów na zajęciach, na których uczysz lub którymi zarządzasz, w Google Classroom. |
https://www.googleapis.com/auth/classroom.topics
|
Wyświetlanie, tworzenie i edytowanie tematów w Google Classroom. |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Wyświetlanie tematów w Google Classroom. |