educationAssignment: publish
Espacio de nombres: microsoft.graph
Publicar una asignación de educación.
Cambie el estado de un educationAssignment de su estado original draft
al published
estado .
Puede cambiar el estado de draft
a scheduled
si la asignación está programada para una fecha futura.
Solo un maestro de la clase puede hacer esta llamada. Cuando una asignación está en estado borrador, los alumnos no verán la asignación ni habrá ningún objeto de envío. Al llamar a esta API, se crean objetos educationSubmission y se muestra la asignación en la lista de cada alumno.
El estado de la asignación vuelve a draft
si hay algún error de back-end durante el proceso de publicación.
Para actualizar las propiedades de una asignación publicada, consulte Actualización de una 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
POST /education/classes/{id}/assignments/{id}/publish
Encabezados de solicitud
Encabezado | Valor |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 Ok
código de respuesta y un objeto educationAssignment en el cuerpo de la respuesta.
Ejemplo
En el siguiente ejemplo se muestra cómo llamar a esta API.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1b6df208-ea5a-475c-8dd2-b92f693c928a/publish
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 Ok
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#educationAssignment",
"@odata.type": "#microsoft.graph.educationAssignment",
"classId": "72a7baec-c3e9-4213-a850-f62de0adad5f",
"displayName": "Reading Test 09.03 3",
"closeDateTime": null,
"dueDateTime": "2021-09-05T06:59:00Z",
"assignDateTime": null,
"assignedDateTime": null,
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"createdDateTime": "2021-09-03T23:26:35.4182773Z",
"lastModifiedDateTime": "2021-09-03T23:28:05.0704312Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "published",
"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%221b6df208-ea5a-475c-8dd2-b92f693c928a%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",
"addedStudentAction": "none",
"id": "1b6df208-ea5a-475c-8dd2-b92f693c928a",
"grading": null,
"instructions": {
"content": "",
"contentType": "text"
},
"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": "AAAAAAAA-0123-4567-89AB-1B4BB48C3119",
"displayName": null
}
}
}