- Ressource: Kurs
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- Methoden
Ressource: Kurs
Ein Kurs in Classroom.
JSON-Darstellung |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
Felder | |
---|---|
id |
Die von Classroom zugewiesene Kennung für diesen Kurs. Wenn Die Angabe dieses Felds in einer Maske für die Aktualisierung des Kurses führt zu einem Fehler. |
name |
Name des Kurses. Beispiel: „10. Klasse Biologie“. Der Name ist erforderlich. Er muss zwischen 1 und 750 Zeichen lang sein und ein gültiger UTF-8-String sein. |
section |
Abschnitt des Kurses. Beispiel: „Zeitraum 2“. Wenn dieses Feld festgelegt ist, muss es ein gültiger UTF-8-String sein und darf nicht länger als 2.800 Zeichen sein. |
descriptionHeading |
Optionale Überschrift für die Beschreibung. Zum Beispiel: „Willkommen bei der 10. Klasse, Biologie“. Wenn dieses Feld festgelegt ist, muss es ein gültiger UTF-8-String sein und darf nicht länger als 3.600 Zeichen sein. |
description |
Optionale Beschreibung. Zum Beispiel: „Wir werden aus einer Kombination aus Lehrbüchern, Gastvorträgen und Laborarbeit etwas über den Aufbau von Lebewesen lernen. Seien Sie gespannt!“ Wenn dieses Feld festgelegt ist, muss es ein gültiger UTF-8-String sein und darf nicht länger als 30.000 Zeichen sein. |
room |
Optionaler Raumstandort. Beispiel: „301“. Wenn dieses Feld festgelegt ist, muss es ein gültiger UTF-8-String sein und darf nicht länger als 650 Zeichen sein. |
ownerId |
Die Kennung des Inhabers eines Kurses. Wenn dieses Feld als Parameter einer
Dies muss in einer Anfrage zur Erstellung festgelegt werden. Administratoren können dieses Feld auch in einem |
creationTime |
Erstellungszeit des Kurses. Die Angabe dieses Felds in einer Maske für die Aktualisierung des Kurses führt zu einem Fehler. Schreibgeschützt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
updateTime |
Zeitpunkt der letzten Aktualisierung dieses Kurses. Die Angabe dieses Felds in einer Maske für die Aktualisierung des Kurses führt zu einem Fehler. Schreibgeschützt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
enrollmentCode |
Anmeldecode für die Teilnahme an diesem Kurs. Die Angabe dieses Felds in einer Maske für die Aktualisierung des Kurses führt zu einem Fehler. Schreibgeschützt. |
courseState |
Status des Kurses. Wenn keine Vorgabe erfolgt, lautet der Standardstatus |
alternateLink |
Link zu diesem Kurs in der Weboberfläche von Classroom. Schreibgeschützt. |
teacherGroupEmail |
Die E-Mail-Adresse einer Google-Gruppe, die alle Lehrkräfte des Kurses enthält. Diese Gruppe akzeptiert keine E-Mails und kann nur für Berechtigungen verwendet werden. Schreibgeschützt. |
courseGroupEmail |
Die E-Mail-Adresse einer Google-Gruppe, die alle Mitglieder des Kurses enthält. Diese Gruppe akzeptiert keine E-Mails und kann nur für Berechtigungen verwendet werden. Schreibgeschützt. |
teacherFolder |
Informationen zu einem Drive-Ordner, der für alle Lehrkräfte des Kurses freigegeben ist. Dieses Feld wird nur für Lehrkräfte des Kurses und für Domainadministratoren festgelegt. Schreibgeschützt. |
courseMaterialSets[] |
Gruppen von Materialien, die auf der Seite „Info“ dieses Kurses angezeigt werden. Schreibgeschützt. |
guardiansEnabled |
Gibt an, ob Benachrichtigungen für Erziehungsberechtigte für diesen Kurs aktiviert sind. Schreibgeschützt. |
calendarId |
Die Kalender-ID für einen Kalender, den alle Kursmitglieder sehen können und dem in Classroom Termine für Kursarbeiten und Ankündigungen im Kurs hinzugefügt werden. Der Kalender für einen Kurs wird asynchron erstellt, wenn er zum ersten Mal auf Schreibgeschützt. |
gradebookSettings |
Die Notenbucheinstellungen, mit denen festgelegt wird, wie die Gesamtnote eines Schülers/Studenten für den Kurs berechnet wird und für wen sie sichtbar ist. Schreibgeschützt |
CourseState
Mögliche Status eines Kurses.
Enums | |
---|---|
COURSE_STATE_UNSPECIFIED |
Kein Kursstatus. Dieser Wert wird von keiner zurückgegebenen Kursnachricht verwendet. |
ACTIVE |
Der Kurs ist aktiv. |
ARCHIVED |
Der Kurs wurde archiviert. Sie können ihn nicht ändern, außer ihn in einen anderen Status zu ändern. |
PROVISIONED |
Der Kurs wurde erstellt, aber noch nicht aktiviert. Die primäre Lehrkraft und die Domainadministratoren können darauf zugreifen und sie ändern oder in den Status ACTIVE oder DECLINED ändern. Ein Kurs kann nur zu PROVISIONED geändert werden, wenn er den Status DECLINED hat. |
DECLINED |
Der Kurs wurde erstellt, aber abgelehnt. Der Kursinhaber und die Domainadministratoren können auf den Kurs zugreifen, er wird aber nicht in der Weboberfläche angezeigt. Sie können den Kurs nur ändern, wenn Sie ihn in den Status PROVISIONED versetzen. Ein Kurs kann nur zu DECLINED geändert werden, wenn er den Status PROVISIONED hat. |
SUSPENDED |
Der Kurs wurde gesperrt. Sie können den Kurs nicht ändern. Nur der über die ownerId angegebene Nutzer kann ihn sehen. Ein Kurs kann diesen Status erhalten, wenn er möglicherweise gegen die Nutzungsbedingungen verstößt. |
CourseMaterialSet
Eine Reihe von Materialien, die auf der Seite „Info“ des Kurses angezeigt werden. Diese Materialien können einen Lehrplan, einen Zeitplan oder andere Hintergrundinformationen zum gesamten Kurs umfassen.
JSON-Darstellung |
---|
{
"title": string,
"materials": [
{
object ( |
Felder | |
---|---|
title |
Titel für diese Gruppe. |
materials[] |
An diesen Satz angehängte Materialien. |
CourseMaterial
Ein Material, das als Teil eines Materialsets einem Kurs beigefügt ist.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld material . Materialdaten. Für material ist nur einer der folgenden Werte zulässig: |
|
driveFile |
Google Drive-Dateianhang. |
youTubeVideo |
YouTube-Videoanhang. |
link |
Linkanhang. |
form |
Google Formulare-Anhang. |
GradebookSettings
Die Notenbuch-Einstellungen für einen Kurs. Weitere Informationen finden Sie in diesem Hilfeartikel.
JSON-Darstellung |
---|
{ "calculationType": enum ( |
Felder | |
---|---|
calculationType |
Gibt an, wie die Gesamtnote berechnet wird. |
displaySetting |
Gibt an, wer die Gesamtnote sehen kann |
gradeCategories[] |
Notenkategorien, die für Kursaufgaben im Kurs verfügbar sind. |
CalculationType
Mögliche Methoden zur Berechnung der Gesamtnote
Enums | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
Keine Methode angegeben. Dies wird nie zurückgegeben. |
TOTAL_POINTS |
Die Gesamtnote ist die Summe der Noten geteilt durch die Summe der Gesamtpunkte unabhängig von der Kategorie. |
WEIGHTED_CATEGORIES |
Die Gesamtnote ist der gewichtete Durchschnitt nach Kategorie. |
DisplaySetting
Mögliche Einstellungen für die Anzeige der Gesamtnote
Enums | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
Keine Einstellung angegeben. Dies wird nie zurückgegeben. |
SHOW_OVERALL_GRADE |
Die Gesamtnote wird Lehrkräften und Schülern/Studenten im Notenbuch und im Schüler-/Studentenprofil angezeigt. |
HIDE_OVERALL_GRADE |
Die Gesamtnote wird nicht im Notenbuch oder im Profil des Schülers/Studenten angezeigt. |
SHOW_TEACHERS_ONLY |
Die Gesamtnote wird Lehrkräften im Notenbuch und im Schüler-/Studentenprofil angezeigt. Wird im Profil des Schülers/Studenten ausgeblendet. |
Methoden |
|
---|---|
|
Gibt zurück, ob ein Nutzer in einem bestimmten Kurs Add-on-Anhänge erstellen darf. |
|
Gibt zurück, ob ein Nutzer „GradingPeriodSettings“ in einem bestimmten Kurs aktualisieren kann. |
|
Erstellt einen Kurs. |
|
Löscht einen Kurs. |
|
Gibt einen Kurs zurück. |
|
Gibt die Einstellungen für den Benotungszeitraum in einem Kurs zurück. |
|
Gibt eine Liste der Kurse zurück, die der anfragende Nutzer ansehen darf, beschränkt auf die Kurse, die der Anfrage entsprechen. |
|
Aktualisiert ein oder mehrere Felder in einem Kurs. |
|
Aktualisiert einen Kurs. |
|
Aktualisiert die Einstellungen für den Benotungszeitraum eines Kurses. |