educationClass-Ressourcentyp

Artikel
05/24/2024

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Klasse in einer Schule dar. Die ressource educationClass entspricht derzeit einer Microsoft 365-Gruppe und verwendet dieselbe ID. Die Schüler sind reguläre Mitglieder des Kurses, und Lehrer sind Eigentümer und haben entsprechende Rechte.

Wichtig

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

Methoden

Methode	Rückgabetyp	Beschreibung
Klasse 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.
Mitglied 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“.
Create	educationAssignment	Create eine neue educationAssignment-Zuweisung durch Posten in der Aufgabensammlung.
Zuweisungen auflisten	educationAssignment-Sammlung	Rufen Sie eine educationAssignment-Objektauflistung ab.
Module auflisten	educationModule-Sammlung	Rufen Sie eine educationModule-Objektauflistung ab.
Gruppe abrufen	Gruppe	Rufen Sie die Microsoft 365-Gruppe ab, die dieser educationClass entspricht.
Kategorie erstellen	educationCategory	Create eine neue educationCategory für diesen Kurs.
Kategorien auflisten	educationCategory-Sammlung	Ruft eine Liste der educationCategory-Objekte ab, die zu dieser Klasse gehören.
Klasse aktualisieren	educationClass	Aktualisieren eines educationClass-Objekts.
Klasse löschen	Keine	Löschen eines educationClass-Objekts.
Delta abrufen	educationClass-Sammlung	Abrufen inkrementeller Änderungen für educationClasses.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	String	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	String	Beschreibung der Klasse
displayName	String	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 von `externalSourceDetail`bestimmt). Mögliche Werte: `sis`, `lms` oder `manual`.
externalSourceDetail	Zeichenfolge	Der Name der externen Quelle, aus der diese Ressourcen generiert wurden.
grade	Zeichenfolge	Notenstufe des Kurses.
mailNickname	String	E-Mail-Name zum Senden von E-Mails an alle Mitglieder, wenn diese Option aktiviert ist.
term	educationTerm	Begriff für die Klasse.

Beziehungen

Beziehung	Typ	Beschreibung
assignments	educationAssignment-Sammlung	Alle Zuweisungen, die dieser Klasse zugeordnet sind. Lässt NULL-Werte zu.
members	educationUser-Sammlung	Alle Benutzer in der Klasse. Nullwerte zulassend.
Module	educationModule-Sammlung	Alle Module in der -Klasse. Nullwerte zulassend.
schools	educationSchool-Sammlung	Alle Schulen, denen dieser Klasse zugeordnet ist. Lässt Nullwerte zu.
teachers	educationUser-Sammlung	Alle Lehrer in der Klasse. Nullwerte zulassend.
assignmentCategories	educationCategory-Sammlung	Alle Dieser Klasse zugeordneten Kategorien. Nullwerte zulassend.
assignmentDefaults	educationAssignmentDefaults-Sammlung	Gibt Standardeinstellungen auf Klassenebene an, die von neuen Zuweisungen berücksichtigt werden, die in der -Klasse erstellt wurden.
assignmentSettings	educationAssignmentSettings-Auflistung	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" }
}

Freigeben über