Crear learningCourseActivity

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Crea un nuevo objeto learningCourseActivity .

Una actividad del curso de aprendizaje puede ser de dos tipos:

Use este método para crear cualquier tipo de actividad.

Nota: Un proveedor puede administrar las actividades del curso de aprendizaje solo cuando isCourseAcitvitySyncEnabled está establecido en true. Para actualizar el valor, use el método Update learningProvider .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) No admitida. No admitida.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación LearningAssignedCourse.ReadWrite.All LearningSelfInitiatedCourse.ReadWrite.All

Solicitud HTTP

POST /employeeExperience/learningProviders/{registrationId}/learningCourseActivities

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, utilice esta opción @odata.type para especificar el tipo de recurso learningCourseActivity que va a crear (learningAssignment o learningSelfInitiated) e incluya las propiedades de ese tipo, tal como se indica en la tabla siguiente.

Propiedad Tipo Descripción
assignedDateTime DateTimeOffset Fecha asignada para la actividad del curso. Opcional.
assignmentType assignmentType El tipo de tarea para la actividad del curso. Los valores posibles son: required, recommended, unknownFutureValue. Obligatorio.
assignerUserId Cadena El ID de usuario del asignador. Opcional.
completedDateTime DateTimeOffset La fecha y hora en que se completó la tarea. Opcional.
completionPercentage Int32 El porcentaje del curso completado por el usuario. Opcional. Si se proporciona un valor, debe estar entre 0 y 100 (inclusive).
dueDateTime DateTimeOffset Fecha de vencimiento de la actividad del curso. Opcional.
externalCourseActivityId Cadena Un identificador de actividad del curso generado por el proveedor. Opcional.
id Cadena El ID generado para una solicitud que se puede utilizar para realizar más interacciones con las API de actividad del curso.
learningContentId Cadena El identificador del contenido de aprendizaje creado en Viva Learning. Obligatorio.
learningProviderId Cadena El identificador de registro del proveedor. Obligatorio.
learnerUserId Cadena El ID de usuario del alumno al que se asigna la actividad. Obligatorio.
notas Cadena Notas para la actividad del curso. Opcional.
identificador de registro Cadena Id. del proveedor. El identificador se genera cuando el proveedor se registra en Viva Learning. Obligatorio.
startedDateTime DateTimeOffset La fecha y hora en que el alumno inició el curso por iniciativa propia. Opcional.
status courseStatus El estado de la actividad del curso. Los valores posibles son: notStarted, inProgress, completed. Obligatorio.

Respuesta

Si se realiza correctamente, este método devuelve un 201 Created código de respuesta y un objeto learningCourseActivity de tipo learningAssignment o learningSelfInitiated en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Crear una actividad asignada del curso de aprendizaje

En el siguiente ejemplo se muestra cómo crear una actividad learningAssignment .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities
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,
  "dueDateTime": {
    "dateTime": "2022-09-22T16:05:00.0000000",
    "timeZone": "UTC"
  },
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learningProviderId": "01e8f81b-3060-4dec-acf0-0389665a0a38",
  "learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
  "notes": {
    "contentType": "text",
    "content": "required assignment added for user"
  },
  "status": "notStarted"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.learningAssignment",
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningCourseActivities('7ba2228a-e020-11ec-9d64-0242ac120002')$entity",
  "assignedDateTime": "2021-05-11T22:57:17+00:00",
  "assignmentType": "required",
  "assignerUserId": "cea1684d-57dc-438d-a9d1-e666ec1a7f3d",
  "completedDateTime": null,
  "completionPercentage": 20,
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "id": "7ba2228a-e020-11ec-9d64-0242ac120002:749c8786-99bb-4b3b-8d5d-586428f6aaa3",
  "dueDateTime": {
    "dateTime": "2022-09-22T16:05:00.0000000",
    "timeZone": "UTC"
  },
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learningProviderId": "01e8f81b-3060-4dec-acf0-0389665a0a38",
  "learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
  "notes": {
    "contentType": "text",
    "content": "required assignment added for user"
  },
  "status": "notStarted"
}

Ejemplo 2: Crear una actividad de curso de aprendizaje iniciada de forma automática

El siguiente ejemplo crea una actividad learningSelfIniciated .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.learningSelfInitiatedCourse",
  "completedDateTime": null,
  "completionPercentage": 20,
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
  "startedDateTime": "2021-05-21T22:57:17+00:00",
  "status": "inProgress"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.learningSelfInitiatedCourse",
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningCourseActivities('be2f4d76-e020-11ec-9d64-0242ac120002')$entity",
  "completedDateTime": null,
  "completionPercentage": 20,
  "externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
  "id": "7ba2228a-e020-11ec-9d64-0242ac120002:749c8786-99bb-4b3b-8d5d-586428f6aaa3",
  "learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
  "learningProviderId": "01e8f81b-3060-4dec-acf0-0389665a0a38",
  "learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
  "startedDateTime": "2021-05-21T22:57:17+00:00",
  "status": "inProgress"
}