Share via


Atualizar learningCourseActivity

Namespace: microsoft.graph

Atualize as propriedades de um objeto learningCourseActivity .

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

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

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

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas
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 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 atribuição foi concluída. Opcional.
completionPercentage Int32 A porcentagem do curso que o usuário conclui. Se um valor for fornecido, ele deverá ser entre 0 e 100 (inclusivo). Opcional.
dueDateTime DateTimeOffset A data de vencimento da atividade do curso. Opcional.
notes String Notas para a atividade do curso. Opcional.
status courseStatus O status da atividade de 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 aprendizagem auto-iniciada (learningSelfInitiated).

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

Resposta

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

Se não tiver êxito, este método retornará uma das respostas abaixo:

Cenário Código HTTP Código Mensagem Detalhes
Método não compatível com a entidade 405 methodNotAllowed Esse método não tem suporte para esse 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 global para solicitar acesso.
Proibido 403 Proibido Você não tem um plano de serviço adequado para essa solicitação.
Solicitação inválida 400 badRequest Esse provedor não está habilitado para o locatário determinado.
Solicitação inválida 400 badRequest Houve um problema com sua solicitação. Verifique se o registroId 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.
Solicitação limitada 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 ausentes {"code": "badRequest","message": "Campo de entrada {fieldName} é necessá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 provedor não é válido para criar atividade de curso para o conteúdo de aprendizagem determinado Quando o registrationId/learningProviderId não corresponde ao provedor com o qual o learningContent é criado.
Proibido 403 Proibido A licença de 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 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 de 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