educationSubmission: unsubmit
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Indique que um aluno deseja trabalhar na atribuição enviada depois que ela foi entregue. Somente professores, alunos e aplicativos com permissões de aplicativo podem executar essa operação.
Esse método altera o status do envio de submitted
para working
. Durante o processo de envio, todos os recursos são copiados de submittedResources para workingResources. O professor examinará a lista de recursos de trabalho para classificação.
Um professor também pode insubmitir a atribuição de um aluno em seu nome.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | EduAssignments.ReadWrite | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | EduAssignments.ReadWrite.All | Notes.ReadWrite.All |
Solicitação HTTP
POST /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}/unsubmit
Cabeçalhos de solicitação
Cabeçalho | Valor |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará 200 Ok
o código de resposta e um objeto educationSubmission no corpo da resposta.
Exemplo
O exemplo a seguir mostra como chamar essa API.
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/7242e03e-048c-437b-8810-3e89b285a362/submissions/3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a/unsubmit
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 Ok
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission",
"@odata.type": "#microsoft.graph.educationSubmission",
"status": "returned",
"submittedDateTime": null,
"unsubmittedDateTime": "2022-10-19T23:14:41.2934772Z",
"returnedDateTime": "2022-04-13T02:09:15.7223872Z",
"reassignedDateTime": null,
"resourcesFolderUrl": 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%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%227242e03e-048c-437b-8810-3e89b285a362%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
"id": "3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
}
}