Obtenir learningCourseActivity
Espace de noms: microsoft.graph
Obtenez l’objet learningCourseActivity spécifié à l’aide d’un ID ou d’un externalCourseActivityId du fournisseur d’apprentissage, ou d’un courseActivityId d’un utilisateur.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | LearningAssignedCourse.Read | LearningSelfInitiatedCourse.Read |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | LearningAssignedCourse.Read.All | LearningSelfInitiatedCourse.Read.All |
Requête HTTP
Pour obtenir une activité de cours d’apprentissage spécifique en fonction de son ID (clé primaire) :
GET /employeeExperience/learningCourseActivities/{Id}
Pour obtenir une activité de cours d’apprentissage spécifique basée sur son externalCourseActivityId (clé secondaire) :
GET /employeeExperience/learningProviders/{registrationId}/learningCourseActivities(externalCourseActivityId='{externalCourseActivityId}')
Pour obtenir les détails d’une activité de cours d’apprentissage pour un utilisateur :
GET users/{user-id}/employeeExperience/learningCourseActivities/{id}
Pour obtenir les détails d’une activité de cours d’apprentissage pour l’utilisateur connecté :
GET me/employeeExperience/learningCourseActivities/{id}
Paramètres facultatifs de la requête
Cette méthode prend en charge les $select
paramètres de requête OData et pour personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et un objet learningCourseActivity dans le corps de la réponse.
En cas d’échec, cette méthode retourne l’une des réponses ci-dessous :
Scénario | Code HTTP | Code | Message |
---|---|---|---|
Méthode non prise en charge pour l’entité | 405 | methodNotAllowed | Cette méthode n’est pas prise en charge pour ce type d’entité. Consultez la documentation Microsoft Graph pour connaître les méthodes applicables à cette entité. |
L’utilisateur n’a pas l’étendue d’autorisation appropriée | 403 | Interdit (Forbidden) | Votre compte n’a pas accès à ce rapport ou à ces données. Contactez votre administrateur pour demander l’accès. |
Interdit (Forbidden) | 403 | Interdit (Forbidden) | Vous n’avez pas de plan de service approprié pour cette demande. |
Demande incorrecte | 400 | badRequest | Ce fournisseur n’est pas activé pour le locataire donné. |
Demande incorrecte | 400 | badRequest | Il y a eu un problème avec votre demande. Assurez-vous que l’id d’inscription que vous avez entré est valide ou inscrit pour votre locataire. |
Demande incorrecte | 404 | notFound | L’ID d’affectation demandé n’existe pas. |
Erreur interne au serveur | 500 | internalServerError | Erreur interne au serveur. |
Demande limitée | 429 | tooManyRequests | {"code » : « tooManyRequests »,"message » : « Retry after {noOfMinutes} minutes"}. |
Service non disponible | 503 | serviceUnavailable | {"code » : « serviceUnavailable »,"message » : « Réessayer après {noOfMinutes} minutes"}. |
Exemples
Exemple 1 : Obtenir une activité de cours d’apprentissage en fonction de son ID
Demande
Les exemples suivants illustrent une demande d’obtention d’une activité de cours d’apprentissage à l’aide d’un ID.
GET https://graph.microsoft.com/v1.0/employeeExperience/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Réponse
L’exemple suivant illustre la réponse.
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"
}
Exemple 2 : Obtenir une activité de cours d’apprentissage basée sur l’externalCourseActivityId du fournisseur d’apprentissage
Demande
L’exemple suivant montre une demande pour obtenir les détails d’une activité de cours d’apprentissage à l’aide d’un ID d’activité de cours externe.
GET https://graph.microsoft.com/v1.0/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities(externalCourseActivityId='12a2228a-e020-11ec-9d64-0242ac120002')
Réponse
L’exemple suivant illustre la réponse.
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"
}
Exemple 3 : Obtenir les détails d’une activité de cours d’apprentissage pour un utilisateur
Demande
L’exemple suivant montre une demande pour obtenir les détails d’une activité de cours d’apprentissage pour un utilisateur.
GET https://graph.microsoft.com/v1.0/users/7ba2228a-e020-11ec-9d64-0242ac120002/employeeExperience/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Réponse
L’exemple suivant illustre la réponse.
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"
}