educationClass-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt eine Klasse in einer Schule dar. Die educationClass-Ressource entspricht derzeit einer Microsoft 365 [Gruppe] und weist dieselbe ID auf. Kursteilnehmer sind reguläre Mitglieder des Kurses, und Lehrer sind Besitzer und verfügen über entsprechende Rechte.

Wichtig

Damit Microsoft 365 Erfahrungen ordnungsgemäß funktionieren, müssen Lehrer Mitglieder sowohl der Lehrer- als auch der Mitgliedersammlung sein.

Methoden

Methode	Rückgabetyp	Beschreibung
EducationClass abrufen	educationClass	Lesen von Eigenschaften und Beziehungen eines educationClass-Objekts.
Mitglied hinzufügen	educationUser	Hinzufügen eines neuen educationUser für die Klasse durch Bereitstellen in der Navigationseigenschaft „members“.
Mitglieder auflisten	educationUser-Sammlung	Abrufen einer educationUser-Objektsammlung.
Kursteilnehmer entfernen	educationUser	Entfernen eines educationUser aus der Klasse über die Navigationseigenschaft „members“.
Schulen auflisten	educationSchool-Sammlung	Abrufen einer educationSchool-Objektsammlung.
Lehrer hinzufügen	educationUser	Hinzufügen eines neuen educationUser für die Klasse durch Bereitstellen in der Navigationseigenschaft „teachers“.
Lehrer auflisten	educationUser-Sammlung	Abrufen einer Liste der Lehrer für die Klasse
Lehrer entfernen	educationUser	Entfernen eines educationUser aus der Klasse über die Navigationseigenschaft „teachers“.
educationAssignment erstellen	educationAssignment	Erstellen Sie ein neues educationAssignment durch Veröffentlichen in der Aufgabensammlung.
Zuweisungen auflisten	[educationAssignmentcollection]	Dient zum Abrufen einer educationAssignment-Objektsammlung .
Gruppe abrufen	group	Rufen Sie die Microsoft 365 Gruppe ab, die dieser educationClass entspricht.
educationCategory erstellen	educationCategory	Erstellen Sie eine neue educationCategory für diesen Kurs.
Kategorien auflisten	[educationCategory-Sammlung]	Dient zum Abrufen einer Liste der educationCategory-Objekte , die zu dieser Klasse gehören.
Aktualisieren	educationClass	Aktualisieren eines educationClass-Objekts.
Delete	Keine	Löschen eines educationClass-Objekts.
Delta abrufen	educationClass-Sammlung	Inkrementelle Änderungen für educationClasses abrufen.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Eindeutiger Bezeichner für die Klasse
classCode	String	Von der Schule verwendeter Klassencode zum Identifizieren der Klasse
Kurs	educationCourse	Kursinformationen für den Kurs.
createdBy	identitySet	Entität, die die Klasse erstellt hat.
description	Zeichenfolge	Beschreibung der Klasse
displayName	Zeichenfolge	Der Name der Klasse
externalId	String	ID der Klasse aus dem Synchronisierungssystem
externalName	String	Der Name der Klasse im Synchronisierungssystem
externalSource	Zeichenfolge	Der Typ der externen Quelle, aus der diese Ressource generiert wurde (automatisch bestimmt aus externalSourceDetail). Mögliche Werte: sis, lms oder manual.
externalSourceDetail	Zeichenfolge	Der Name der externen Quelle, aus der diese Ressourcen generiert wurden.
grade	String	Benotungsstufe der Klasse.
mailNickname	Zeichenfolge	E-Mail-Name zum Senden von E-Mails an alle Mitglieder, wenn diese Option aktiviert ist.
term	educationTerm	Ausdruck für die Klasse.

Beziehungen

Beziehung	Typ	Beschreibung
assignments	[educationAssignment-Sammlung]	Alle diesem Kurs zugeordneten Aufgaben. Lässt NULL-Werte zu.
members	educationUser-Sammlung	Alle Benutzer in der Klasse. Lässt Nullwerte zu.
schools	educationSchool-Sammlung	Alle Schulen, denen dieser Klasse zugeordnet ist. Lässt Nullwerte zu.
teachers	educationUser-Sammlung	Alle Lehrer in der Klasse. Lässt Nullwerte zu.
assignmentCategories	educationCategory-Sammlung	Alle Kategorien, die dieser Klasse zugeordnet sind. Lässt NULL-Werte zu.
assignmentDefaults	educationAssignmentDefaults-Sammlung	Gibt Standardwerte auf Klassenebene an, die von neuen In der Klasse erstellten Zuordnungen berücksichtigt werden.
assignmentSettings	educationAssignmentSettings-Sammlung	Gibt Zuweisungseinstellungen auf Klassenebene an.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "classCode": "String",
  "course": { "@odata.type": "microsoft.graph.educationCourse" },
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "description": "String",
  "displayName": "String",
  "externalId": "String",
  "externalName": "String",
  "externalSource": "string",
  "grade": "string",
  "id": "String (identifier)",
  "mailNickname": "String",
  "term": { "@odata.type": "microsoft.graph.educationTerm" }
}