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.
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
}
}
}