REST Resource: courses

{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  }
}

string

Die von Classroom zugewiesene Kennung für diesen Kurs.

Wenn creating a course, können Sie diese ID in der Anfrage optional auf eine alias string festlegen, um einen entsprechenden Alias zu erstellen. Die id wird weiterhin von Classroom zugewiesen und kann nach dem Erstellen des Kurses nicht mehr aktualisiert werden.

Die Angabe dieses Felds in einer Maske für die Aktualisierung des Kurses führt zu einem Fehler.

string

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.

string

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.

string

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.

string

Optionale Beschreibung. 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.

string

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.

string

Die Kennung des Inhabers eines Kurses.

Wenn dieses Feld als Parameter einer create course request angegeben wird, ist es erforderlich. Folgende Kennzeichnungen sind möglich:

• die numerische Kennung für den Nutzer,
• die E-Mail-Adresse des Nutzers
• Das Stringliteral "me", das den anfragenden Nutzer angibt

Dies muss in einer Anfrage zur Erstellung festgelegt werden. Administratoren können dieses Feld auch in einem patch course request angeben, um die Inhaberschaft zu übertragen. In anderen Kontexten ist sie schreibgeschützt.

string (Timestamp format)

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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string

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.

enum (CourseState)

Status des Kurses. Wenn keine Vorgabe erfolgt, lautet der Standardstatus PROVISIONED.

string

Link zu diesem Kurs in der Classroom-Web-UI.

Schreibgeschützt.

string

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.

string

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.

object (DriveFolder)

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.

object (CourseMaterialSet)

Gruppen von Materialien, die im Infobereich angezeigt werden dieses Kurses behandelt.

Schreibgeschützt.

boolean

Gibt an, ob Benachrichtigungen für Erziehungsberechtigte für diesen Kurs aktiviert sind.

Schreibgeschützt.

string

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 CourseState.ACTIVE gesetzt wird (bei der Erstellung oder wenn er über die Benutzeroberfläche oder die API auf ACTIVE aktualisiert wird). Die Kalender-ID wird erst eingefügt, wenn die Erstellung abgeschlossen ist.

Schreibgeschützt.

object (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

{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}

string

Titel für diese Gruppe.

object (CourseMaterial)

An diesen Satz angehängte Materialien.

{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}

object (DriveFile)

Google Drive-Dateianhang.

object (YouTubeVideo)

YouTube-Videoanhang.

object (Link)

Linkanhang.

object (Form)

Google Formulare-Anhang.

{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}

enum (CalculationType)

Gibt an, wie die Gesamtnote berechnet wird.

enum (DisplaySetting)

Gibt an, wer die Gesamtnote sehen kann

object (GradeCategory)

Notenkategorien, die für Kursaufgaben im Kurs verfügbar sind.