Atualizar learningCourseActivity

Namespace: microsoft.graph

Atualize as propriedades de um objeto learningCourseActivity .

Observação: as atividades do curso de aprendizado podem ser gerenciadas por um provedor somente quando isCourseAcitvitySyncEnabled estiver definido como true. Para atualizar o valor, use o método Update learningProvider .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados
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 da solicitação, use @odata.type para especificar o tipo de recurso learningCourseActivity (learningAssignment ou learningSelfInitiated) e inclua as propriedades desse tipo a serem atualizadas.

A tabela a seguir lista as propriedades que você pode alterar para uma atividade de curso de aprendizado 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 atribuição foi concluída. Opcional.
completionPercentage Int32 A porcentagem do curso que o usuário conclui. Se um valor for fornecido, ele deverá estar entre 0 e 100 (inclusivo). Opcional.
dueDateTime DateTimeOffset A data de vencimento para a 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 a seguir lista as propriedades que você pode alterar para uma atividade de curso de aprendizado iniciado automaticamente (learningSelfInitiated).

Propriedade Tipo Descrição
completedDateTime DateTimeOffset Data e hora em que a atribuição foi concluída. Opcional.
completionPercentage Int32 A porcentagem do curso concluído pelo usuário. Se um valor for fornecido, ele deverá estar entre 0 e 100 (inclusivo). Opcional.
status courseStatus O status da atividade do curso. Os valores possíveis são: inProgress, completed. Obrigatório.
startedDateTime DateTimeOffset A data e hora em que o aluno iniciou o curso iniciado automaticamente.

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 retornará uma das respostas abaixo:

Cenário Código HTTP Código Mensagem Detalhes
Método sem suporte para entidade 405 methodNotAllowed Esse método não tem suporte para este tipo de entidade. Consulte a documentação do Microsoft Graph para obter os métodos aplicáveis a essa entidade.
O usuário não tem o escopo de permissão apropriado 403 Proibido Sua conta não tem acesso a este relatório ou dados. Entre em contato com o administrador para solicitar acesso.
Proibido 403 Proibido Você não tem um plano de serviço adequado para esta solicitação.
Solicitação inválida 400 solicitação ruim Esse provedor não está habilitado para o locatário determinado.
Solicitação inválida 400 solicitação ruim Houve um problema com sua solicitação. Verifique se o registrationId inserido é válido ou registrado para seu locatário.
Solicitação inválida 404 notFound A ID de atribuição solicitada não existe.
Erro de servidor interno 500 internalServerError Erro de servidor interno.
Pedido regulado 429 tooManyRequests {"code": "tooManyRequests","message": "Tentar novamente após {noOfMinutes} minutos".}
Serviço indisponível 503 serviceUnavailable {"code": "serviceUnavailable","message": "Tentar novamente após {noOfMinutes} minutos"}.
Solicitação inválida 400 solicitação ruim Os campos obrigatórios estão ausentes {"code": "badRequest","message": "Campo de entrada {fieldName} é obrigatório"}.
Solicitação inválida 400 solicitação ruim Os campos de entrada são inválidos {"code": "badRequest","message": "Campo de entrada {fieldName} é inválido"}.
Solicitação inválida 400 solicitação ruim solicitação ruim {"code": "badRequest","message": "O campo de entrada {fieldName} não deve estar vazio"}.
Proibido 403 Proibido O provedor não é válido para criar a atividade do curso para o conteúdo de aprendizado fornecido Quando registrationId/learningProviderId não corresponde ao provedor com o qual o learningContent é criado.
Proibido 403 Proibido A licença do usuário não é válida para executar a operação Quando o usuário para o qual a atribuição está sendo criada não tem uma licença premium.

Exemplos

Exemplo 1: Atualizar uma atividade de curso de aprendizado 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 de curso de aprendizagem iniciada automaticamente

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