educationClass-Ressourcentyp
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 | Erstellen Sie ein neues educationAssignment , indem Sie in der Aufgabensammlung veröffentlichen. |
| 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 | Erstellen Sie eine neue educationCategory für diese Klasse. |
| 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. |
| Abrufen kürzlich geänderter Übermittlungen | educationSubmission-Sammlung | 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 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 | String | Der Typ der externen Quelle, aus der diese Ressource generiert wurde (automatisch von externalSourceDetailbestimmt). Mögliche Werte: sis, lms oder manual. |
| externalSourceDetail | String | Der Name der externen Quelle, aus der diese Ressource generiert wurde. |
| grade | String | 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
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" }
}