Dieses Dokument enthält API-spezifische Autorisierungs- und Authentifizierungsinformationen für die Google Classroom API. Lesen Sie sich vor diesem Dokument die allgemeinen Informationen zur Authentifizierung und Autorisierung in Google Workspace unter Weitere Informationen zur Authentifizierung und Autorisierung durch.
OAuth 2.0 für die Autorisierung konfigurieren
Konfigurieren Sie den OAuth-Zustimmungsbildschirm und wählen Sie Bereiche aus, um festzulegen, welche Informationen Nutzern und App-Prüfern angezeigt werden. Registrieren Sie dann Ihre App für die spätere Veröffentlichung.
Classroom API-Bereiche
Um die Zugriffsebene für Ihre App zu definieren, müssen Sie Autorisierungsbereiche angeben. Ein Autorisierungsbereich ist ein OAuth 2.0-URI-String, der den Namen der Google Workspace-App, die Art der Daten, auf die zugegriffen wird, und die Zugriffsebene enthält. Bereiche sind die Anfragen Ihrer App zur Verarbeitung von Google Workspace-Daten, einschließlich der Google-Kontodaten der Nutzer.
Wenn Ihre App installiert wird, wird ein Nutzer aufgefordert, die von der App verwendeten Bereiche zu bestätigen. Im Allgemeinen sollten Sie den möglichst eng gefassten Bereich auswählen und Bereiche vermeiden, die für Ihre App nicht erforderlich sind. Nutzer gewähren leichter Zugriff auf eingeschränkte, klar beschriebene Bereiche.
Die Classroom API unterstützt die folgenden Bereiche:
Ebenen | Bedeutung |
---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Sie können die Anhänge des anfragenden Google Cloud-Projekts aufrufen, erstellen und aktualisieren, um Elemente in von Ihnen geleiteten Google Classroom-Kursen zu streamen. |
https://www.googleapis.com/auth/classroom.addons.student
|
Rufen Sie die Anhänge des anfragenden Google Cloud-Projekts auf und aktualisieren Sie sie, um Elemente in Google Classroom zu streamen. |
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
|
Rufen Sie Ihre Google Classroom-Kurse auf. |
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
|
Ihre Kursaufgaben und Noten in Google Classroom abrufen. |
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
|
Sehen Sie sich Kursaufgaben und Noten für Teilnehmer an den von Ihnen geleiteten oder verwalteten Google Classroom-Kursen an. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Kursaufgabenmaterial in Google Classroom aufrufen, 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 abrufen und verwalten. |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Erziehungsberechtigte für Teilnehmer in Ihren Google Classroom-Kursen abrufen |
https://www.googleapis.com/auth/classroom.profile.emails
|
E-Mail-Adressen von Personen in Ihren 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
|
Rufen Sie die Teilnehmerlisten Ihrer Google Classroom-Kurse auf. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Rufen Sie Ihre Kursarbeiten und Noten in Google Classroom ab. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Kursarbeiten und Noten für Schüler/Studenten ansehen, die an von Ihnen geleiteten oder verwalteten Google Classroom-Kursen teilnehmen. |
https://www.googleapis.com/auth/classroom.topics
|
Themen in Google Classroom erstellen, aufrufen und bearbeiten |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Rufen Sie Themen in Google Classroom auf. |