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.

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.