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 autoryzacji w Google Workspace, które znajdziesz w artykule Więcej informacji o uwierzytelnianiu i autoryzacji.
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 później opublikować.
Zakresy interfejsu Classroom API
Aby określić poziom dostępu przyznanego aplikacji, musisz zidentyfikować i zadeklarować zakresy autoryzacji. Zakres autoryzacji to ciąg znaków URI OAuth 2.0 zawierający nazwę aplikacji Google Workspace, rodzaj danych, do których ma ona dostęp, oraz poziom dostępu. Zakresy to żądania aplikacji dotyczące dostępu do danych Google Workspace, w tym danych z konta Google użytkowników.
Po zainstalowaniu aplikacji użytkownik musi zatwierdzić zakresy używane przez aplikację. Zazwyczaj należy wybrać jak najbardziej ograniczony zakres i unikać żądania zakresów, których aplikacja nie wymaga. 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 żądającego projektu Google Cloud w celu przesyłania strumieniowego elementów 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 danych z projektu Google Cloud, który wysłał żądanie, do elementów w Google Classroom. |
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świetlaj, twórz i trwale usuwaj swoje zajęcia 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 kursu, np. 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świetlanie zdjęć profilowych osób z Twoich zajęć. |
https://www.googleapis.com/auth/classroom.push-notifications
|
otrzymywać powiadomienia związane z danymi w Google Classroom; |
https://www.googleapis.com/auth/classroom.rosters
|
Zarządzaj listami uczniów 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 |