Wybierz zakresy interfejsu API Google Classroom

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.