Actualización de 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.
Actualice un objeto educationAssignment .
Sólo los maestros de la clase pueden hacer esto. No se puede usar una solicitud PATCH para cambiar el estado de una asignación. Use la acción de publicación para cambiar el estado de la asignación .
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) | EduAssignments.ReadWriteBasic | EduAssignments.ReadWrite |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | No admitida. | No admitida. |
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 la autenticación y la 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 se incluyen 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 | Description |
---|---|---|
addedStudentAction | Cadena | Controla el comportamiento de los alumnos que se agregan después de publicar la asignación. |
addToCalendarAction | educationAddToCalendarOptions | Campo opcional para controlar el comportamiento de la asignación para agregar asignaciones a los calendarios de alumnos y profesores cuando se publica la asignación. Los valores posibles son: none , studentsAndPublisher , studentsAndTeamOwners , studentsOnly y unknownFutureValue . El valor predeterminado es none . No se puede modificar cuando la asignación está en published estado. |
allowLateSubmissions | Booleano | Si los envíos se pueden enviar después de la fecha de vencimiento. |
allowStudentsToAddResourcesToSubmission | Booleano | Si un alumno puede agregar recursos a un envío. Indica si los únicos elementos del envío proceden de la lista de recursos de asignación. |
assignDateTime | DateTimeOffset | Fecha en la que se debe publicar la asignación a los alumnos. No se puede editar cuando se publica la asignación. |
assignTo | educationAssignmentRecipient | Estudiantes que obtienen la asignación. |
closeDateTime | DateTimeOffset | Fecha en que se cierra la asignación para los envíos. Este es un campo opcional que puede ser NULL si la asignación no permiteLateSubmissions 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 | La asignación de fecha vence. |
Clasificación | educationAssignmentGradeType | Cómo se clasifica la asignación. |
Instrucciones | itemBody | Instrucciones que se deben dar a los alumnos junto con la asignación. |
notificationChannelUrl | Cadena | Canalizar para publicar la notificación de publicación de asignación. No se permite actualizar la dirección URL del canal después de publicar la asignación y solo se permite cuando el valor assignTo es educationAssignmentClassRecipient. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de 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",
"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",
"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
}
}
}