Obtención de learningCourseActivity
Espacio de nombres: microsoft.graph
Obtenga el objeto learningCourseActivity especificado mediante un identificador o externalCourseActivityId del proveedor de aprendizaje o un courseActivityId de un usuario.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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) | LearningAssignedCourse.Read | LearningSelfInitiatedCourse.Read |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | LearningAssignedCourse.Read.All | LearningSelfInitiatedCourse.Read.All |
Solicitud HTTP
Para obtener una actividad específica del curso de aprendizaje basada en su identificador (clave principal):
GET /employeeExperience/learningCourseActivities/{Id}
Para obtener una actividad específica del curso de aprendizaje basada en su externalCourseActivityId (clave secundaria):
GET /employeeExperience/learningProviders/{registrationId}/learningCourseActivities(externalCourseActivityId='{externalCourseActivityId}')
Para obtener los detalles de una actividad de curso de aprendizaje para un usuario:
GET users/{user-id}/employeeExperience/learningCourseActivities/{id}
Para obtener los detalles de una actividad de curso de aprendizaje para el usuario que ha iniciado sesión:
GET me/employeeExperience/learningCourseActivities/{id}
Parámetros de consulta opcionales
Este método admite y $select
otros parámetros de consulta de OData para personalizar la respuesta. Para obtener información general, vea Parámetros de consulta OData.
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto learningCourseActivity en el cuerpo de la respuesta.
Si no se realiza correctamente, este método devuelve una de las respuestas siguientes:
Escenario | Código HTTP | Código | Mensaje |
---|---|---|---|
Método no compatible con la entidad | 405 | methodNotAllowed | Este método no se admite para este tipo de entidad. Consulte la documentación de Microsoft Graph para ver los métodos aplicables a esta entidad. |
El usuario no tiene el ámbito de permisos adecuado | 403 | Prohibido (Forbidden) | Su cuenta no tiene acceso a este informe o a los datos. Póngase en contacto con el administrador para solicitar acceso. |
Prohibido (Forbidden) | 403 | Prohibido (Forbidden) | No tiene un plan de servicio adecuado para esta solicitud. |
Solicitud incorrecta | 400 | badRequest | Este proveedor no está habilitado para el inquilino determinado. |
Solicitud incorrecta | 400 | badRequest | Se produjo un problema con la solicitud. Asegúrese de que el identificador de registro especificado es válido o registrado para el inquilino. |
Solicitud incorrecta | 404 | notFound | El identificador de asignación solicitado no existe. |
Error interno del servidor. | 500 | internalServerError | Error interno del servidor. |
Solicitud limitada | 429 | tooManyRequests | {"code": "tooManyRequests","message": "Retry after {noOfMinutes} minutes"}. |
Servicio no disponible | 503 | serviceUnavailable | {"code": "serviceUnavailable","message": "Retry after {noOfMinutes} minutes"}. |
Ejemplos
Ejemplo 1: Obtención de una actividad de curso de aprendizaje en función de su identificador
Solicitud
En los ejemplos siguientes se muestra una solicitud para obtener una actividad del curso de aprendizaje mediante un identificador.
GET https://graph.microsoft.com/v1.0/employeeExperience/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.learningAssignment",
"@odata.context": "https://graph.microsoft.com/v1.0/$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": null,
"dueDateTime": {
"dateTime": "2022-09-22T16:05:00.0000000",
"timeZone": "UTC"
},
"externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
"id": "8ba2228a-e020-11ec-9d64-0242ac120003",
"learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
"learningProviderId": "13727311-e7bb-470d-8b20-6a23d9030d70",
"learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
"notes": {
"contentType": "text",
"content": "required assignment added for user"
},
"status": "notStarted"
}
Ejemplo 2: Obtención de una actividad de curso de aprendizaje basada en externalCourseActivityId del proveedor de aprendizaje
Solicitud
En el ejemplo siguiente se muestra una solicitud para obtener los detalles de una actividad del curso de aprendizaje mediante un identificador de actividad de curso externo.
GET https://graph.microsoft.com/v1.0/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities(externalCourseActivityId='12a2228a-e020-11ec-9d64-0242ac120002')
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.learningAssignment",
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#learningProviders('01e8f81b-3060-4dec-acf0-0389665a0a38')/learningCourseActivities('8ba2228a-e020-11ec-9d64-0242ac120003')$entity",
"assignedDateTime": "2021-05-11T22:57:17+00:00",
"assignerUserId": "cea1684d-57dc-438d-a9d1-e666ec1a7f3d",
"assignmentType": "required",
"completedDateTime": null,
"completionPercentage": null,
"externalCourseActivityId": "12a2228a-e020-11ec-9d64-0242ac120002",
"id": "8ba2228a-e020-11ec-9d64-0242ac120003",
"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 3: Obtener los detalles de una actividad de curso de aprendizaje para un usuario
Solicitud
En el ejemplo siguiente se muestra una solicitud para obtener los detalles de una actividad de curso de aprendizaje para un usuario.
GET https://graph.microsoft.com/v1.0/users/7ba2228a-e020-11ec-9d64-0242ac120002/employeeExperience/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.learningAssignment",
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#learningProviders('13727311-e7bb-470d-8b20-6a23d9030d70')/learningCourseActivities('8ba2228a-e020-11ec-9d64-0242ac120003')$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": "8ba2228a-e020-11ec-9d64-0242ac120003",
"dueDateTime": {
"dateTime": "2022-09-22T16:05:00.0000000",
"timeZone": "UTC"
},
"learningContentId": "57baf9dc-e020-11ec-9d64-0242ac120002",
"learningProviderId": "13727311-e7bb-470d-8b20-6a23d9030d70",
"learnerUserId": "7ba2228a-e020-11ec-9d64-0242ac120002",
"notes": {
"contentType": "text",
"content": "required assignment added for user"
},
"status": "notStarted"
}