Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Atualizar um objeto educationAssignment .
Apenas os professores podem efetuar esta ação.
Em alternativa, peça para alterar a status de uma atribuição com a ação de publicação. Não utilize uma operação PATCH para esta finalidade.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | EduAssignments.ReadWriteBasic | EduAssignments.ReadWrite |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | EduAssignments.ReadWriteBasic.All | EduAssignments.ReadWrite.All |
Solicitação HTTP
PATCH /education/classes/{class-id}/assignments/{assignment-id}
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json |
Corpo da solicitação
No corpo do pedido, forneça apenas os valores dos campos que pretende atualizar.
As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.
| Propriedade | Tipo | Descrição |
|---|---|---|
| addedStudentAction | Cadeia de caracteres | Descreve se a tarefa deve ser distribuída aos estudantes que são adicionados após a data de publicação da tarefa. |
| addToCalendarAction | educationAddToCalendarOptions | Campo opcional para controlar o comportamento da tarefa para adicionar tarefas aos calendários dos estudantes e professores quando a tarefa é publicada. Os valores possíveis são: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValue, studentsOnly. Utilize o cabeçalho do Prefer: include - unknown -enum-members pedido para obter os seguintes membros nesta enumeração em evolução: studentsOnly. Opcional. |
| allowLateSubmissions | Booliano | Se os estudantes podem enviar a submissão após a data para conclusão. |
| allowStudentsToAddResourcesToSubmission | Booliano | Se um estudante pode ou não adicionar recursos a uma submissão. Além disso, indica se todos os recursos na submissão correspondem à lista de recursos de atribuição. |
| assignDateTime | DateTimeOffset | Indica a data para publicar a tarefa aos estudantes. Não é possível editar quando a tarefa é publicada. |
| assignTo | educationAssignmentRecipient | Estudantes que recebem a tarefa. |
| closeDateTime | DateTimeOffset | Data em que a atribuição é fechada para submissões. Este é um campo opcional que pode ser nulo se a atribuição não permitirLateSubmissions ou o closeDateTime for o mesmo que dueDateTime, mas, se especificado, tem de ser maior ou igual ao dueDateTime. |
| displayName | Cadeia de caracteres | Nome da tarefa. |
| dueDateTime | DateTimeOffset | A atribuição de data está para conclusão. |
| classificação | educationAssignmentGradeType | Como a tarefa é classificada. |
| instruções | itemBody | Instruções a serem dadas aos estudantes juntamente com a tarefa. |
| languageTag | Cadeia de caracteres | Especifica o idioma no qual são apresentadas as notificações de IU para a atribuição. Se languageTag não for fornecido, o idioma predefinido é en-US. Opcional. |
| notificationChannelUrl | Cadeia de caracteres | O canal para comunicar notificações relacionadas com a atribuição. Para alterar o URL, defina o assignTo valor como educationAssignmentClassRecipient. O URL do canal não pode ser alterado após a publicação da tarefa. |
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto educationAssignment atualizado no corpo da resposta.
Exemplo
Solicitação
Eis um exemplo do pedido.
PATCH https://graph.microsoft.com/v1.0/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"
}
Resposta
Veja um exemplo de resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$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",
"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
}
}
}