Dieses Dokument enthält Google Classroom API-spezifische Autorisierungs- und Authentifizierungsinformationen. Bevor Sie dieses Dokument lesen, sollten Sie sich die allgemeinen Informationen zur Authentifizierung und Autorisierung in Google Workspace unter Authentifizierung und Autorisierung ansehen.
OAuth 2.0 für die Autorisierung konfigurieren
OAuth-Zustimmungsbildschirm konfigurieren und Bereiche auswählen: Damit legen Sie fest, welche Informationen Nutzern und App-Prüfern angezeigt werden. Außerdem registrieren Sie Ihre App, damit Sie sie später veröffentlichen können.
Classroom API-Bereiche
Um den Zugriff zu definieren, der Ihrer App gewährt wird, müssen Sie Autorisierungsbereiche identifizieren und deklarieren. Ein Autorisierungsbereich ist ein OAuth 2.0-URI-String, der den Namen der Google Workspace-App, die Art der Daten, auf die sie zugreift, und die Zugriffsebene enthält. Bereiche sind die Anfragen Ihrer App, mit Google Workspace-Daten zu arbeiten, einschließlich der Google-Kontodaten von Nutzern.
Wenn Ihre App installiert wird, werden Nutzer aufgefordert, die von der App verwendeten Bereiche zu bestätigen. Im Allgemeinen sollten Sie den engsten möglichen Bereich auswählen und keine Bereiche anfordern, die Ihre App nicht benötigt. Nutzer gewähren eher Zugriff auf eingeschränkte, klar beschriebene Bereiche.
Die Classroom API unterstützt die folgenden Bereiche:
| Bereiche | Bedeutung |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Anhänge des anfragenden Google Cloud-Projekts für Stream-Elemente in von Ihnen geleiteten Google Classroom-Kursen erstellen, aufrufen und aktualisieren. |
https://www.googleapis.com/auth/classroom.addons.student
|
Anhänge des anfragenden Google Cloud-Projekts für Stream-Elemente in Google Classroom aufrufen und aktualisieren. |
https://www.googleapis.com/auth/classroom.announcements
|
Ankündigungen in Google Classroom abrufen und verwalten |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Ankündigungen in Google Classroom ansehen |
https://www.googleapis.com/auth/classroom.courses
|
Ihre Google Classroom-Kurse abrufen, bearbeiten, erstellen oder endgültig löschen |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Eigene Google Classroom-Kurse ansehen |
https://www.googleapis.com/auth/classroom.coursework.me
|
Zum Kursmaterial gehörende Inhalte erstellen, abrufen und bearbeiten, beispielsweise Aufgaben, Fragen und Noten. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Kursarbeiten und Noten in Google Classroom ansehen |
https://www.googleapis.com/auth/classroom.coursework.students
|
Kursarbeiten und Noten für Teilnehmer an von Ihnen geleiteten Google Classroom-Kursen verwalten sowie Kursarbeiten und Noten für von Ihnen verwaltete Kurse abrufen. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Kursarbeiten und Noten für Teilnehmer an von Ihnen geleiteten oder verwalteten Google Classroom-Kursen abrufen |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Kursaufgabenmaterial in Google Classroom abrufen, bearbeiten und erstellen |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Gesamtes Kursaufgabenmaterial zu Ihren Google Classroom-Kursen abrufen |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Google Classroom-Erziehungsberechtigte abrufen |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Erziehungsberechtigte für Teilnehmer in Ihren Google Classroom-Kursen ansehen und verwalten. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Erziehungsberechtigte für Teilnehmer in Ihren Google Classroom-Kursen ansehen |
https://www.googleapis.com/auth/classroom.profile.emails
|
E-Mail-Adressen von Nutzern in Kursen ansehen |
https://www.googleapis.com/auth/classroom.profile.photos
|
Profilfotos von Nutzern in Kursen ansehen |
https://www.googleapis.com/auth/classroom.push-notifications
|
Benachrichtigungen zu Ihren Google Classroom-Daten erhalten |
https://www.googleapis.com/auth/classroom.rosters
|
Teilnehmerlisten der eigenen Google Classroom-Kurse verwalten |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Teilnehmerlisten der eigenen Google Classroom-Kurse abrufen |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Kursarbeiten und Noten in Google Classroom ansehen |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Kursarbeiten und Noten für Teilnehmer an von Ihnen geleiteten oder verwalteten Google Classroom-Kursen abrufen |
https://www.googleapis.com/auth/classroom.topics
|
Themen in Google Classroom erstellen, ansehen und bearbeiten |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Themen in Google Classroom ansehen |