Actualizar educationassignment

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.

Actualizar un objeto educationAssignment .

Solo los profesores de la clase pueden hacer esto. No puede usar una solicitud PATCH para cambiar el estado de una tarea. Use la acción publicar para cambiar el estado de la asignación .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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) EduAssignments.ReadWriteBasic EduAssignments.ReadWrite
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación EduAssignments.ReadWriteBasic.All EduAssignments.ReadWrite.All

Solicitud HTTP

PATCH /education/classes/{class-id}/assignments/{assignment-id}

Encabezados de solicitud

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

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad. Para obtener el mejor rendimiento, no incluya valores existentes que no hayan cambiado.

Propiedad Tipo Descripción
addedStudentAction Cadena Controla el comportamiento de los alumnos que se agregan después de publicar la tarea.
addToCalendarAction educationAddToCalendarOptions Campo opcional para controlar el comportamiento de la tarea de agregar tareas a los calendarios de los alumnos y profesores cuando se publique la tarea. Los valores posibles son: none, studentsAndPublisher, studentsAndTeamOwners, studentsOnly, unknownFutureValue. El valor predeterminado es none. No se puede modificar cuando la asignación está en published estado.
allowLateSubmissions Booleano Si las presentaciones se pueden enviar después de la fecha de vencimiento.
allowStudentsToAddResourcesToSubmission Booleano Si un alumno puede agregar recursos a un envío. Indicó si los únicos elementos del envío procedían de la lista de recursos de la asignación.
assignDateTime DateTimeOffset Fecha en que la tarea debe publicarse para los alumnos. No se puede editar cuando se publica la tarea.
assignTo educationAssignmentRecipient Alumnos que reciben la tarea.
closeDateTime DateTimeOffset Fecha en la que se cierra la tarea para envíos. Este es un campo opcional que puede ser null si la asignación no allowLateSubmissions o closeDateTime es el mismo que dueDateTime pero, si se especifica, debe ser mayor o igual que dueDateTime.
displayName Cadena Nombre de la asignación.
dueDateTime DateTimeOffset Fecha de vencimiento.
Calificación educationAssignmentGradeType Cómo se califica la tarea.
Instrucciones itemBody Instrucciones que se darán a los estudiantes junto con la tarea.
languageTag Cadena Especifica el idioma en el que se muestran las notificaciones de la interfaz de usuario para la tarea. Si no se proporciona languageTag , el idioma predeterminado es en-US. Opcional.
notificationChannelUrl Cadena Canal para publicar notificación de publicación de tarea. No se permite actualizar la dirección URL del canal después de que se haya publicado la tarea y solo se permite cuando el valor assignTo es educationAssignmentClassRecipient.

Respuesta

Si se realiza correctamente, este método devuelve un código de 200 OK respuesta y un objeto educationAssignment actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/4679bc1b-90c5-45af-ae1a-d5357672ed39
Content-type: application/json

{
    "displayName": "Reading and review test 09.03 #5",
    "instructions": {
        "contentType": "text",
        "content": "Read chapter 5 and write your review"
    },
    "dueDateTime": "2021-09-10T00:00:00Z",
    "addedStudentAction": "none",
    "languageTag": "pt-BR",
    "addToCalendarAction": "studentsAndPublisher"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments/$entity",
    "classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
    "displayName": "Reading and review test 09.03 #5",
    "closeDateTime": null,
    "dueDateTime": "2021-09-10T00:00:00Z",
    "assignDateTime": null,
    "assignedDateTime": null,
    "allowLateSubmissions": true,
    "resourcesFolderUrl": null,
    "createdDateTime": "2021-09-03T23:57:14.6088791Z",
    "lastModifiedDateTime": "2021-09-04T15:01:35.3361649Z",
    "allowStudentsToAddResourcesToSubmission": true,
    "status": "draft",
    "notificationChannelUrl": null,
    "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2272a7baec-c3e9-4213-a850-f62de0adad5f%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%224679bc1b-90c5-45af-ae1a-d5357672ed39%5C%22%5D%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22assignment-viewer%5C%22%7D%22,%22channelId%22%3Anull%7D",
    "addToCalendarAction": "studentsAndPublisher",
    "addedStudentAction": "none",
    "languageTag": "pt-BR",
    "id": "4679bc1b-90c5-45af-ae1a-d5357672ed39",
    "instructions": {
        "content": "Read chapter 5 and write your review",
        "contentType": "text"
    },
    "grading": {
        "@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
        "maxPoints": 50
    },
    "assignTo": {
        "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
    },
    "createdBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
            "displayName": null
        }
    },
    "lastModifiedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
            "displayName": null
        }
    }
}