educationClass resource type
Namespace: microsoft.graph
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a class within a school. The educationClass resource currently corresponds to a Microsoft 365 group and shares the same ID. Students are regular members of the class, and Teachers are owners and have appropriate rights.
Important
For Microsoft 365 experiences to work correctly, teachers must be members of both the teachers and members collections.
Methods
Method | Return Type | Description |
---|---|---|
Get class | educationClass | Read properties and relationships of an educationClass object. |
Add member | educationUser | Add a new educationUser for the class by posting to the members navigation property. |
List members | educationUser collection | Get an educationUser object collection. |
Remove member | educationUser | Remove an educationUser from the class through the members navigation property. |
List schools | educationSchool collection | Get an educationSchool object collection. |
Add teacher | educationUser | Add a new educationUser for the class by posting to the teachers navigation property. |
List teachers | educationUser collection | Get a list of teachers for the class. |
Remove teacher | educationUser | Remove an educationUser from the class through the teachers navigation property. |
Create | educationAssignment | Create a new educationAssignment by posting to the assignments collection. |
List assignments | educationAssignmentcollection | Get an educationAssignment object collection. |
List modules | educationModulecollection | Get an educationModule object collection. |
Get group | group | Get the Microsoft 365 group that corresponds to this educationClass. |
Create category | educationCategory | Create a new educationCategory for this class. |
List categories | educationCategory collection | Get a list of educationCategory objects that belong to this class. |
Update class | educationClass | Update educationClass object. |
Delete class | None | Delete educationClass object. |
Get delta | educationClass collection | Get incremental changes for educationClasses. |
Properties
Property | Type | Description |
---|---|---|
id | String | Unique identifier for the class. |
classCode | String | Class code used by the school to identify the class. |
course | educationCourse | Course information for the class. |
createdBy | identitySet | Entity who created the class. |
description | String | Description of the class. |
displayName | String | Name of the class. |
externalId | String | ID of the class from the syncing system. |
externalName | String | Name of the class in the syncing system. |
externalSource | String | The type of external source this resource was generated from (automatically determined from externalSourceDetail ). Possible values are: sis , lms , or manual . |
externalSourceDetail | String | The name of the external source this resources was generated from. |
grade | String | Grade level of the class. |
mailNickname | String | Mail name for sending email to all members, if this is enabled. |
term | educationTerm | Term for the class. |
Relationships
Relationship | Type | Description |
---|---|---|
assignments | educationAssignment collection | All assignments associated with this class. Nullable. |
members | educationUser collection | All users in the class. Nullable. |
modules | educationModule collection | All modules in the class. Nullable. |
schools | educationSchool collection | All schools that this class is associated with. Nullable. |
teachers | educationUser collection | All teachers in the class. Nullable. |
assignmentCategories | educationCategory collection | All categories associated with this class. Nullable. |
assignmentDefaults | educationAssignmentDefaults collection | Specifies class-level defaults respected by new assignments created in the class. |
assignmentSettings | educationAssignmentSettings collection | Specifies class-level assignments settings. |
JSON representation
The following JSON representation shows the resource type.
{
"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" }
}
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기