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-Rezensenten angezeigt werden. Registrieren Sie dann Ihre App, damit Sie sie später veröffentlichen können.

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 eher Zugriff auf eingeschränkte, klar beschriebene Bereiche.

Wenn Ihre öffentliche Anwendung Bereiche verwendet, die den Zugriff auf bestimmte Nutzerdaten erlauben, muss sie ein Überprüfungsverfahren durchlaufen. Wenn Sie beim Testen Ihrer Anwendung auf dem Bildschirm nicht überprüfte App sehen, müssen Sie einen Überprüfungsantrag einreichen, um die Meldung zu entfernen. Weitere Informationen zu nicht bestätigten Apps und Antworten auf häufig gestellte Fragen zur App-Bestätigung finden Sie in der Hilfe.

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	Rufen Sie Ihre Kursarbeiten und Noten in Google Classroom ab.
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 Schüler/Studenten ansehen, die an von Ihnen geleiteten oder verwalteten Google Classroom-Kursen teilnehmen.
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 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 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	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, ansehen und bearbeiten
https://www.googleapis.com/auth/classroom.topics.readonly	Rufen Sie die Themen in Google Classroom auf.