Compartilhar via


Atualizar aprendizagemCourseActivity

Namespace: microsoft.graph

Atualize as propriedades de um objeto learningCourseActivity .

Nota: as atividades do curso de aprendizagem só podem ser geridas por um fornecedor quando isCourseAcitvitySyncEnabled está definido como true. Para atualizar o valor, utilize o método Update learningProvider .

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) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application LearningAssignedCourse.ReadWrite.All LearningSelfInitiatedCourse.ReadWrite.All

Solicitação HTTP

PATCH /employeeExperience/learningProviders/{registrationId}/learningCourseActivities/{learningCourseActivityId}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, utilize @odata.type para especificar o tipo de recurso learningCourseActivity (learningAssignment ou learningSelfInitiated) e inclua as propriedades desse tipo para atualizar.

A tabela seguinte lista as propriedades que pode alterar para uma atividade de curso de aprendizagem atribuída (learningAssignment).

Propriedade Tipo Descrição
assignedDateTime DateTimeOffset Data atribuída para a atividade do curso. Opcional.
completedDateTime DateTimeOffset Data e hora em que a tarefa foi concluída. Opcional.
completionPercentage Int32 A percentagem do curso que o utilizador conclui. Se for fornecido um valor, tem de estar entre 0 e 100 (inclusive). Opcional.
dueDateTime DateTimeOffset A data para conclusão da atividade do curso. Opcional.
notes String Notas para a atividade do curso. Opcional.
status courseStatus O status da atividade do curso. Os valores possíveis são notStarted, inProgress, completed. Obrigatório.

A tabela seguinte lista as propriedades que pode alterar para uma atividade do curso de aprendizagem auto-iniciada (learningSelfInitiated).

Propriedade Tipo Descrição
completedDateTime DateTimeOffset Data e hora em que a tarefa foi concluída. Opcional.
completionPercentage Int32 A percentagem do curso concluído pelo utilizador. Se for fornecido um valor, tem de estar entre 0 e 100 (inclusive). Opcional.
status courseStatus O status da atividade do curso. Os valores possíveis são: inProgress e completed. Obrigatório.
startedDateTime DateTimeOffset A data e hora em que o formando iniciou o curso auto-iniciado.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Se não for bem-sucedido, este método devolve uma das respostas abaixo:

Cenário Código HTTP Código Mensagem Detalhes
Método não suportado para a entidade 405 methodNotAllowed Este método não é suportado para este tipo de entidade. Veja a documentação do Microsoft Graph para obter os métodos aplicáveis a esta entidade.
O utilizador não tem o âmbito de permissão adequado 403 Proibido A sua conta não tem acesso a este relatório ou dados. Contacte o administrador para pedir acesso.
Proibido 403 Proibido Não tem um plano de serviço adequado para este pedido.
Solicitação inválida 400 badRequest Este fornecedor não está ativado para o inquilino especificado.
Solicitação inválida 400 badRequest Ocorreu um problema com o seu pedido. Certifique-se de que o registrationId introduzido é válido ou está registado no seu inquilino.
Solicitação inválida 404 notFound O ID de atribuição pedido não existe.
Erro de servidor interno 500 internalServerError Erro de servidor interno.
Pedido limitado 429 tooManyRequests {"code": "tooManyRequests","message": "Retry after {noOfMinutes} minutes".}
Serviço indisponível 503 serviceUnavailable {"code": "serviceUnavailable","message": "Retry after {noOfMinutes} minutes"}.
Solicitação inválida 400 badRequest Os campos necessários estão em falta {"code": "badRequest","message": "Campo de entrada {fieldName} é obrigatório"}.
Solicitação inválida 400 badRequest Os campos de entrada são inválidos {"code": "badRequest","message": "Campo de entrada {fieldName} é inválido"}.
Solicitação inválida 400 badRequest badRequest {"code": "badRequest","message": "Campo de entrada {fieldName} não deve estar vazio"}.
Proibido 403 Proibido O fornecedor não é válido para criar a atividade do curso para o conteúdo de aprendizagem fornecido Quando registrationId/learningProviderId não corresponde ao fornecedor com o qual o learningContent é criado.
Proibido 403 Proibido A licença de utilizador não é válida para executar a operação Quando o utilizador para o qual a atribuição está a ser criada não tem uma licença premium.

Exemplos

Exemplo 1: Atualizar uma atividade do curso de aprendizagem atribuída

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.learningAssignment",
  "assignedDateTime": "2021-05-11T22:57:17+00:00",
  "assignmentType": "required",
  "assignerUserId": "cea1684d-57dc-438d-a9d1-e666ec1a7f3d",
  "completedDateTime": null,
  "completionPercentage": 20,
  "learningProviderId": "01e8f81b-3060-4dec-acf0-0389665a0a38",
  "dueDateTime": {
    "dateTime": "2022-09-22T16:05:00.0000000",
    "timeZone": "UTC"
  },
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
  "notes": {
    "contentType": "text",
    "content": "required assignment added for user"
  },
  "status": "inProgress"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: Atualizar uma atividade do curso de aprendizagem auto-iniciada

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.learningSelfInitiatedCourse",
  "completedDateTime": null,
  "completionPercentage": 30,
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learningProviderId": "01e8f81b-3060-4dec-acf0-0389665a0a38",
  "startedDateTime": "2021-05-11T22:57:17+00:00",
  "status": "inProgress"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content