Ten dokument zawiera informacje na temat autoryzacji i uwierzytelniania w interfejsie Google Classroom API. Przed przeczytaniem tego dokumentu zapoznaj się z ogólnymi informacjami o uwierzytelnianiu i autoryzowaniu w Google Workspace w artykule Więcej informacji o uwierzytelnianiu i autoryzowaniu.
Konfigurowanie OAuth 2.0 na potrzeby autoryzacji
Konfigurowanie ekranu zgody OAuth i wybieranie zakresów, aby określić, jakie informacje są wyświetlane użytkownikom i sprawdzającym aplikację, oraz zarejestrować aplikację, aby można ją było opublikować.
Zakresy interfejsu Classroom API
Aby określić poziom dostępu przyznanego aplikacji, musisz zidentyfikować 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 uzyskuje ona dostęp, oraz poziom dostępu. Zakresy to żądania aplikacji dotyczące danych Google Workspace, w tym danych z konta Google użytkowników.
Po zainstalowaniu aplikacji użytkownik jest proszony o sprawdzenie zakresów używanych przez nią. Należy wybrać jak najwęższy możliwy zakres i uniknąć wysyłania żądań o zakresy, których aplikacja nie potrzebuje. Użytkownicy chętniej udzielają dostępu do ograniczonych, jasno opisanych zakresów.
Interfejs Classroom API obsługuje te zakresy:
| Zakresy | Znaczenie |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Wyświetlanie, tworzenie i aktualizowanie załączników do projektu Google Cloud, który wysyła żądanie, aby przesyłać strumieniowo elementy na zajęciach, które prowadzisz w Google Classroom. |
https://www.googleapis.com/auth/classroom.addons.student
|
Wyświetlanie i aktualizowanie załączników do przesyłania elementów z Google Classroom do projektu Google Cloud, który wysłał żądanie. |
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świetlać swoje zajęcia w Google Classroom; |
https://www.googleapis.com/auth/classroom.coursework.me
|
Wyświetlanie, tworzenie i edytowanie elementów kursu, w tym projektów, pytań i ocen. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Wyświetlanie zadań i ocen na zajęciach w Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.students
|
Zarządzanie zadaniami i ocenami uczniów na zajęciach w Google Classroom, na których uczysz oraz wyświetlanie zadań i ocen na zajęciach, którymi administrujesz. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Wyświetlanie zadań i ocen uczniów na zajęciach w Google Classroom, na których uczysz lub którymi zarządzasz |
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
|
Wyświetlanie wszystkich materiałów 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 w klasach 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
|
otrzymywać powiadomienia dotyczące 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 na zajęciach w Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Wyświetlanie zadań i ocen uczniów na zajęciach w Google Classroom, na których uczysz lub którymi zarządzasz |
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 |