Atualizar learningCourseActivity

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.

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.
Aplicativo 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.
assignmentType assignmentType O tipo de atribuição para a atividade do curso. Os valores possíveis são: required, recommended, unknownFutureValue. Obrigatório.
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.
dueDateTime DateTimeOffset Data de vencimento para a 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: notStarted, inProgress, completed. Obrigatório.
startedDateTime DateTimeOffset A data e a hora em que o curso auto-iniciado foi iniciado pelo aluno.

Resposta

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

Exemplos

Exemplo 1: atualizar uma atividade de curso de aprendizagem atribuída

Solicitação

O exemplo a seguir mostra a solicitação.

PATCH https://graph.microsoft.com/beta/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 a solicitação.

PATCH https://graph.microsoft.com/beta/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