Compartir a través de


Crear educationClass

Espacio de nombres: microsoft.graph

Cree un nuevo objeto educationClass .

Nota:

Esto también creará un grupo universal. Cuando use esta API para crear una clase, agregará propiedades especiales al grupo, que agregarán características como asignaciones y control especial dentro de Microsoft Teams cuando se creen equipos mediante el grupo. Tenga en cuenta que esta API solo crea el grupo universal y no crea un equipo. Microsoft Teams proporciona una interfaz de usuario para que los profesores creen equipos para sus propias clases mediante los grupos creados por esta API.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) No admitida. No admitida.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación EduRoster.ReadWrite.All No disponible.

Solicitud HTTP

POST /education/classes

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto educationClass .

En la tabla siguiente se enumeran las propiedades necesarias al crear educationClass.

Propiedad Tipo Descripción
id Cadena Identificador de objeto. Heredado de la entidad
displayName String Nombre de la clase.
mailNickname String Nombre de correo para enviar correo electrónico a todos los miembros, si esta opción está habilitada.
description String Descripción de la clase
createdBy identitySet Entidad que ha creado la clase.
classCode String Código de clase que usa el centro educativo para identificar la clase.
externalName String Nombre de la clase en el sistema de sincronización.
externalId String Identificador de la clase en el sistema de sincronización.
externalSource educationExternalSource Forma en que se ha creado la clase. Los valores posibles son: sis, manual
externalSourceDetail Cadena Nombre del origen externo desde el que se generaron estos recursos.
grade Cadena Nivel de grado de la clase.
term educationTerm Período de la clase.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto educationClass en el cuerpo de la respuesta.

Ejemplos

Solicitud

POST https://graph.microsoft.com/v1.0/education/classes
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.educationClass",
  "displayName": "String",
  "mailNickname": "String",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "classCode": "String",
  "externalName": "String",
  "externalId": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "grade": "String",
  "term": {
    "@odata.type": "microsoft.graph.educationTerm"
  }
}

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.educationClass",
  "id": "64ef8ce5-8ce5-64ef-e58c-ef64e58cef64",
  "displayName": "String",
  "mailNickname": "String",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "classCode": "String",
  "externalName": "String",
  "externalId": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "grade": "String",
  "term": {
    "@odata.type": "microsoft.graph.educationTerm"
  }
}