Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 educationClass-Ressource entspricht derzeit einer Microsoft 365-Gruppe und hat dieselbe ID. Schüler/Studenten sind reguläre Mitglieder der Klasse, und Lehrkräfte sind Eigentümer und verfügen über 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“. |
| Aufgabe erstellen | educationAssignment | Erstellen Sie eine neue educationAssignment , indem Sie sie in der Aufgabensammlung veröffentlichen. |
| Zuweisungen auflisten | educationAssignment-Sammlung | Rufen Sie eine educationAssignment-Objektsammlung ab. |
| Module auflisten | educationModule-Sammlung | Abrufen einer "educationModule" -Objektsammlung. |
| Gruppe abrufen | Gruppe | Rufen Sie die Microsoft 365-Gruppe ab, die dieser educationClass entspricht. |
| Kategorie erstellen | educationCategory | Erstellen Sie eine neue "educationCategory" für diesen Kurs. |
| Kategorien auflisten | educationCategory-Sammlung | Rufen Sie 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. |
| Abrufen kürzlich geänderter Übermittlungen | educationSubmission collection | Abrufen von Übermittlungen, die in den letzten sieben Tagen geändert wurden. |
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 den Kurs 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 bestimmt aus externalSourceDetail). Die möglichen Werte sind: sis, lms, oder manual. |
| externalSourceDetail | Zeichenfolge | Der Name der externen Quelle, aus der diese Ressource generiert wurde. |
| grade | Zeichenfolge | Klassenstufe der Klasse. |
| 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 diesem Kurs zugeordneten Aufgaben. 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 Kategorien, die dieser Klasse zugeordnet sind. Nullwerte zulassend. |
| assignmentDefaults | educationAssignmentDefaults-Sammlung | Gibt Standardwerte auf Klassenebene an, die von neuen Zuweisungen berücksichtigt werden, die in der Klasse erstellt werden. |
| assignmentSettings | educationAssignmentSettings-Auflistung | Gibt Einstellungen für Aufgaben auf Klassenebene an. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"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" }
}