Compartilhar via


Atualizar o educationassignment

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
        }
    }
}