Partager via


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"
}