Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 ID. Los estudiantes son miembros regulares de la clase y los maestros son propietarios y tienen los derechos apropiados.
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 una tarea | educationAssignment | Cree una tarea educativa publicándola en la colección de tareas. |
| Enumerar tareas | Colección educationAssignment | Obtener una colección de objetos educationAssignment . |
| Enumerar módulos | Colección educationModule | Obtener una colección de objetos educationModule . |
| Obtener grupo | group | Obtenga el grupo de Microsoft 365 correspondiente a esta educationClass. |
| Crear categoría | educationCategory | Cree una nueva EducationCategory para esta clase. |
| Enumerar categorías | Colección educationCategory | Obtener una lista de los 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. |
| Obtener envíos modificados recientemente | educationSubmission collection | Recuperar 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 para 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 para la clase. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| assignments | Colección educationAssignment | Todas las tareas asociadas con esta clase. Admite valores NULL. |
| members | Colección educationUser | Todos los usuarios de la clase. Admite valores NULL. |
| módulos digitales | Colección educationModule | Todos los módulos de la clase. Admite valores 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 con esta clase. Admite valores NULL. |
| assignmentDefaults | Colección educationAssignmentDefaults | Especifica los valores predeterminados a nivel de clase que respetan las nuevas asignaciones creadas en la clase. |
| assignmentSettings | colección educationAssignmentSettings | Especifica la configuración de las tareas 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" }
}