Google Classroom API-Bereiche auswählen

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.