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
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.
Atualizar um objeto educationAssignment .
Apenas os professores na turma podem fazê-lo. Não pode utilizar um pedido PATCH para alterar a status de uma tarefa. Utilize a ação de publicação para alterar a atribuição status.
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 da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. 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 | Controla o comportamento dos estudantes que são adicionados após a 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, studentsOnly, unknownFutureValue. O valor padrão é none. Não é possível modificar quando a atribuição está em published status. |
| allowLateSubmissions | Booliano | Se as submissões podem ser submetidas após a data para conclusão. |
| allowStudentsToAddResourcesToSubmission | Booliano | Se um estudante pode adicionar recursos a uma submissão. Indicou se os únicos itens na submissão vieram da lista de recursos de atribuição. |
| assignDateTime | DateTimeOffset | Data em que a tarefa deve ser publicada para os 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 | Canal para publicar notificação de publicação de atribuição. A atualização do URL do canal não é permitida após a publicação da atribuição e só é permitida quando o valor assignTo é educationAssignmentClassRecipient. |
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
O exemplo a seguir mostra uma solicitação.
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"
}
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
{
"@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
}
}
}