Tipo de recurso educationClass
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta
de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa una clase en un centro educativo. El recurso educationClass corresponde actualmente a un grupo de Microsoft 365 y comparte el mismo identificador. Los alumnos son miembros regulares de la clase, y los profesores son propietarios y tienen los derechos adecuados.
Importante
Para que las experiencias de Microsoft 365 funcionen correctamente, los profesores deben ser miembros de las colecciones de profesores y miembros.
Métodos
Método | Tipo de valor devuelto | Descripción |
---|---|---|
Obtener clase | educationClass | Lea las propiedades y relaciones de un objeto educationClass. |
Agregar miembro | educationUser | Agregue un nuevo educationUser en la clase publicando en la propiedad de navegación de miembros. |
Enumerar miembros | Colección educationUser | Obtenga una colección de objetos educationUser. |
Eliminar miembro | educationUser | Quite un educationUser de la clase mediante la propiedad de navegación de miembros. |
Enumerar centros educativos | Colección educationSchool | Obtenga una colección de objetos educationSchool. |
Agregar profesor | educationUser | Agregue un nuevo educationUser en la clase publicando en la propiedad de navegación de profesores. |
Enumerar profesores | Colección educationUser | Obtenga una lista de los profesores de la clase. |
Quitar profesor | educationUser | Quite un educationUser de la clase mediante la propiedad de navegación de profesores. |
Crear | educationAssignment | Cree un nuevo educationAssignment mediante la publicación en la colección de asignaciones. |
Enumerar tareas | colección educationAssignment | Obtenga una colección de objetos educationAssignment . |
Enumerar módulos | educationModule (colección) | Obtenga una colección de objetos educationModule . |
Obtener grupo | group | Obtenga el grupo de Microsoft 365 que corresponde a esta clase educationClass. |
Crear categoría | educationCategory | Cree una nueva educationCategory para esta clase. |
Enumerar categorías | colección educationCategory | Obtenga una lista de objetos educationCategory que pertenecen a esta clase. |
Actualizar clase | educationClass | Actualice un objeto educationClass. |
Eliminar clase | Ninguno | Elimine un objeto educationClass. |
Obtener delta | Colección educationClass | Obtenga cambios incrementales para educationClasses. |
Obtención de envíos modificados recientemente | colección educationSubmission | Recupere los envíos modificados en los siete días anteriores. |
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
id | String | Identificador único de la clase |
classCode | String | Código de clase que usa el centro educativo para identificar la clase. |
curso | educationCourse | Información del curso de la clase. |
createdBy | identitySet | Entidad que creó la clase . |
description | String | Descripción de la clase |
displayName | String | Nombre de la clase. |
externalId | String | Identificador de la clase en el sistema de sincronización. |
externalName | String | Nombre de la clase en el sistema de sincronización. |
externalSource | Cadena | El tipo de origen externo desde el que se generó este recurso (determinado automáticamente a partir de externalSourceDetail ). Los valores posibles son sis , lms o manual . |
externalSourceDetail | Cadena | Nombre del origen externo desde el que se generó este recurso. |
grade | Cadena | Nivel de grado de la clase. |
mailNickname | String | Nombre de correo para enviar correo electrónico a todos los miembros, si esta opción está habilitada. |
term | educationTerm | Término de la clase . |
Relaciones
Relación | Tipo | Descripción |
---|---|---|
assignments | colección educationAssignment | Todas las asignaciones asociadas a esta clase. Admite valores NULL. |
members | Colección educationUser | Todos los usuarios de la clase. Admite un valor NULL. |
Módulos | educationModule (colección) | Todos los módulos de la clase . Admite un valor NULL. |
schools | Colección educationSchool | Todos los centros educativos a los que está asociada la clase. Admite valores NULL. |
teachers | Colección educationUser | Todos los profesores de la clase. Admite valores NULL. |
assignmentCategories | colección educationCategory | Todas las categorías asociadas a esta clase. Admite valores NULL. |
assignmentDefaults | educationAssignmentDefaults (colección) | Especifica los valores predeterminados de nivel de clase respetados por las nuevas asignaciones creadas en la clase . |
assignmentSettings | colección educationAssignmentSettings | Especifica la configuración de asignaciones de nivel de clase. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"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" }
}