Ten dokument zawiera informacje na temat autoryzacji i uwierzytelniania w interfejsie Google Classroom API. Zanim przeczytasz ten dokument, zapoznaj się z ogólnymi informacjami o uwierzytelnianiu i autoryzacji w Google Workspace, które znajdziesz w artykule Uwierzytelnianie i autoryzacja.
Konfigurowanie OAuth 2.0 na potrzeby autoryzacji
Skonfiguruj ekran zgody OAuth i wybierz zakresy, aby określić, jakie informacje będą wyświetlane użytkownikom i osobom weryfikującym aplikację, oraz zarejestrować aplikację, aby móc ją później opublikować.
Zakresy interfejsu Classroom API
Aby określić poziom dostępu przyznany aplikacji, musisz zidentyfikować i zadeklarować zakresy autoryzacji. Zakres autoryzacji to ciąg znaków URI OAuth 2.0, który zawiera nazwę aplikacji Google Workspace, rodzaj danych, do których ma ona dostęp, oraz poziom dostępu. Zakresy to żądania aplikacji dotyczące pracy z danymi Google Workspace, w tym z danymi kont Google użytkowników.
Gdy aplikacja zostanie zainstalowana, użytkownik jest proszony o potwierdzenie zakresów używanych przez aplikację. Zazwyczaj należy wybrać jak najwęższy zakres i unikać żądania zakresów, których aplikacja nie potrzebuje. Użytkownicy chętniej przyznają dostęp 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 elementów strumienia w klasach, które prowadzisz w Google Classroom, w projekcie Google Cloud, który wysyła żądanie. |
https://www.googleapis.com/auth/classroom.addons.student
|
Wyświetlanie i aktualizowanie załączników do elementów strumienia w Google Classroom w projekcie Google Cloud, który wysył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świetl zajęcia 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ądzać rozkładami zajęć w Google Classroom; |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
wyświetlać rozkłady 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. |