Obter educationSubmission
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.
Recupere um envio específico. Somente professores, alunos e aplicativos com permissões de aplicativo podem executar essa operação.
Um objeto de envio representa o trabalho de um aluno para uma atribuição. Os recursos associados ao envio representam esse trabalho.
Somente o atribuídoTo aluno pode ver e modificar o envio. Um professor ou aplicativo com permissões de aplicativo tem acesso total a todos os envios.
A nota e os comentários de um professor fazem parte do educationOutcome associado a esse objeto. Somente professores ou aplicativos com permissões de aplicativo podem adicionar ou alterar notas e comentários. Os alunos não verão a nota ou os comentários até que a tarefa tenha sido liberada.
Forneça o cabeçalho Prefer: include-unknown-enum-members
para listar corretamente os envios com o reassigned
status. Para obter detalhes, confira a seção exemplos.
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.ReadBasic | EduAssignments.Read, EduAssignments.ReadWrite, EduAssignments.ReadWriteBasic |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | EduAssignments.ReadBasic.All | EduAssignments.Read.All, EduAssignments.ReadWrite.All, EduAssignments.ReadWriteBasic.All |
Solicitação HTTP
GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}
Parâmetros de consulta opcionais
Esse método dá suporte aos $select
parâmetros de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
Cabeçalhos de solicitação
Cabeçalho | Valor |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Preferir |
include-unknown-enum-members . Opcional. |
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á um 200 OK
código de resposta e um objeto educationSubmission no corpo da resposta.
Exemplos
Exemplo 1: Solicitação sem Cabeçalho preferencial opcional
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a
Resposta
O exemplo a seguir mostra a resposta.
Notas: O objeto de resposta mostrado aqui pode ser abreviado para legibilidade.
Se setUpResourcesFolder ainda não tiver sido chamado para esse recurso educationSubmission , a propriedade resourcesFolderUrl será
null
.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 712
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "returned",
"submittedDateTime": null,
"unsubmittedDateTime": null,
"returnedDateTime": "2022-04-13T05:11:50.756165Z",
"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%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%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": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"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": null,
"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
}
}
}
Exemplo 2: Solicitação com Cabeçalho preferencial opcional
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5
Prefer: include-unknown-enum-members
Resposta
O exemplo a seguir mostra a resposta.
Notas: O objeto de resposta mostrado aqui pode ser abreviado para legibilidade.
Se setUpResourcesFolder ainda não tiver sido chamado para esse recurso educationSubmission , a propriedade resourcesFolderUrl será
null
.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 712
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "reassigned",
"submittedDateTime": "2022-04-13T05:10:00.4660243Z",
"unsubmittedDateTime": null,
"returnedDateTime": "2022-04-13T05:12:14.6531582Z",
"reassignedDateTime": "2022-04-13T05:12:14.6531582Z",
"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%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%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": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"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
}
}
}
Exemplo 3: obter envio com opções de $expand
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/education/classes/a86a5c30-0437-49d6-9c6b-b1ce0d8d5574/assignments/95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f/submissions/e1a0240e-f3af-f039-63e7-09c3cbf8d176?$expand=*
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 4492
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions(outcomes(),resources(),submittedResources())/$entity",
"status": "returned",
"submittedDateTime": "2022-10-24T21:03:53.3664034Z",
"unsubmittedDateTime": null,
"returnedDateTime": "2022-10-24T21:04:42.7101616Z",
"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%22a86a5c30-0437-49d6-9c6b-b1ce0d8d5574%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%2295da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22e1a0240e-f3af-f039-63e7-09c3cbf8d176%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": "e1a0240e-f3af-f039-63e7-09c3cbf8d176",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"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
}
},
"outcomes@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/outcomes",
"outcomes": [
{
"@odata.type": "#microsoft.graph.educationFeedbackOutcome",
"lastModifiedDateTime": "2022-10-24T21:04:42.3073523Z",
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"feedback": {
"feedbackDateTime": "2022-10-24T21:04:42.3073523Z",
"text": {
"content": "New feedback!",
"contentType": "text"
},
"feedbackBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
}
},
"publishedFeedback": {
"feedbackDateTime": "2022-10-24T21:04:25.2783852Z",
"text": {
"content": "Feedback",
"contentType": "text"
},
"feedbackBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
}
}
},
{
"@odata.type": "#microsoft.graph.educationPointsOutcome",
"lastModifiedDateTime": "2022-10-24T21:04:42.7101541Z",
"id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"points": {
"gradedDateTime": "2022-10-24T21:04:42.7101541Z",
"points": 456,
"gradedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
}
},
"publishedPoints": {
"gradedDateTime": "2022-10-24T21:04:25.6308301Z",
"points": 123,
"gradedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
}
}
},
{
"@odata.type": "#microsoft.graph.educationRubricOutcome",
"lastModifiedDateTime": "2022-10-24T21:04:26.5833776Z",
"id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"rubricQualityFeedback": [
{
"qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null
},
{
"qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
"feedback": {
"content": "Needs improvement",
"contentType": "text"
}
},
{
"qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null
}
],
"rubricQualitySelectedLevels": [
{
"qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null
},
{
"qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
"columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
},
{
"qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null
}
],
"publishedRubricQualityFeedback": [
{
"qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null
},
{
"qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
"feedback": {
"content": "Needs improvement",
"contentType": "text"
}
},
{
"qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null
}
],
"publishedRubricQualitySelectedLevels": [
{
"qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null
},
{
"qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
"columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
},
{
"qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null
}
]
}
],
"resources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/resources",
"resources": [],
"submittedResources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/submittedResources",
"submittedResources": []
}