Google Classroom API-Bereiche auswählen

Dieses Dokument enthält Autorisierungs- und Authentifizierungsinformationen für die Google Classroom API. Bevor Sie dieses Dokument lesen, sollten Sie die allgemeinen Informationen zur Authentifizierung und Autorisierung von Google Workspace unter Informationen zur Authentifizierung und Autorisierung lesen.

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 Anwendungsprüfern angezeigt werden. Registrieren Sie Ihre Anwendung, damit Sie sie später veröffentlichen können.

Classroom API-Bereiche

Zum Definieren der Zugriffsebene für Ihre Anwendung müssen Sie Autorisierungsbereiche identifizieren und deklarieren. Ein Autorisierungsbereich ist ein OAuth 2.0-URI-String, der den Namen der Google Workspace-Anwendung, die Art von Daten, auf die zugegriffen wird, und die Zugriffsebene enthält. Bereiche sind die Anfragen Ihrer Anwendung zur Arbeit mit Google Workspace-Daten, einschließlich der Google-Kontodaten von Nutzern.

Wenn Ihre Anwendung installiert ist, wird ein Nutzer aufgefordert, die von der Anwendung verwendeten Bereiche zu validieren. Im Allgemeinen sollten Sie den engsten Fokusbereich auswählen und vermeiden, Bereiche anzufordern, die Ihre Anwendung nicht benötigt. Nutzer gewähren leichter Zugriff auf eingeschränkte, klar beschriebene Bereiche.

Wenn Ihre öffentliche Anwendung Bereiche verwendet, die den Zugriff auf bestimmte Nutzerdaten erlauben, muss sie einen Überprüfungsprozess durchlaufen. Wenn beim Testen der Anwendung auf dem Bildschirm die Meldung Nicht überprüfte Anwendung angezeigt wird, müssen Sie eine Überprüfungsanfrage senden, um die Anwendung zu entfernen. Weitere Informationen zu nicht überprüften Anwendungen und Antworten auf häufig gestellte Fragen zur Anwendungsüberprüfung finden Sie in der Hilfe.

Die Classroom API unterstützt die folgenden Bereiche:

Ebenen	Bedeutung
https://www.googleapis.com/auth/classroom.announcements	Ankündigungen in Google Classroom ansehen 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 aufrufen, bearbeiten, erstellen oder endgültig löschen.
https://www.googleapis.com/auth/classroom.courses.readonly	Ihre Google Classroom-Kurse aufrufen.
https://www.googleapis.com/auth/classroom.coursework.me	Kursaufgaben, einschließlich Aufgaben, Fragen und Noten, aufrufen, erstellen und bearbeiten
https://www.googleapis.com/auth/classroom.coursework.me.readonly	Kursaufgaben und Noten in Google Classroom ansehen
https://www.googleapis.com/auth/classroom.coursework.students	Sie können Kursaufgaben und Noten für Teilnehmer an von Ihnen geleiteten Google Classroom-Kursen verwalten sowie die Kursaufgaben und Noten für die von Ihnen verwalteten Kurse abrufen.
https://www.googleapis.com/auth/classroom.coursework.students.readonly	Kursaufgaben und Noten für Teilnehmer an von Ihnen geleiteten oder verwalteten Google Classroom-Kursen abrufen
https://www.googleapis.com/auth/classroom.courseworkmaterials	Kursaufgaben in Google Classroom ansehen, bearbeiten und erstellen
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly	Hier finden Sie alle Kursaufgaben für Ihre Google Classroom-Kurse.
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	Sehen Sie sich die E-Mail-Adressen von Teilnehmern in Ihren Kursen an.
https://www.googleapis.com/auth/classroom.profile.photos	Profilbilder von Personen in Ihren Kursen ansehen.
https://www.googleapis.com/auth/classroom.push-notifications	Sie erhalten Benachrichtigungen zu Ihren Google Classroom-Daten.
https://www.googleapis.com/auth/classroom.rosters	Hier können Sie die Teilnehmerlisten für Ihre Google Classroom-Kurse verwalten.
https://www.googleapis.com/auth/classroom.rosters.readonly	Die Teilnehmerlisten Ihrer Google Classroom-Kurse aufrufen.
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly	Kursaufgaben und Noten in Google Classroom ansehen
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly	Kursaufgaben 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.