Abrufen von LearningCourseActivity
Namespace: microsoft.graph
Rufen Sie das angegebene learningCourseActivity-Objekt mithilfe einer ID oder einer externalCourseActivityId des Lernanbieters oder einer courseActivityId eines Benutzers ab.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | LearningAssignedCourse.Read | LearningSelfInitiatedCourse.Read |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | LearningAssignedCourse.Read.All | LearningSelfInitiatedCourse.Read.All |
HTTP-Anforderung
So rufen Sie eine bestimmte Lernkursaktivität basierend auf ihrer ID (Primärschlüssel) ab:
GET /employeeExperience/learningCourseActivities/{Id}
So rufen Sie eine bestimmte Lernkursaktivität basierend auf ihrer externalCourseActivityId (sekundärem Schlüssel) ab:
GET /employeeExperience/learningProviders/{registrationId}/learningCourseActivities(externalCourseActivityId={externalCourseActivityId})
So rufen Sie die Details einer Lernkursaktivität für einen Benutzer ab:
GET users/{user-id}/employeeExperience/learningCourseActivities/{id}
So rufen Sie die Details einer Lernkursaktivität für den angemeldeten Benutzer ab:
GET me/employeeExperience/learningCourseActivities/{id}
Optionale Abfrageparameter
Diese Methode unterstützt die $select
und andere OData-Abfrageparameter, um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK
Antwortcode und ein learningCourseActivity-Objekt im Antworttext zurück.
Wenn die Methode nicht erfolgreich ist, wird eine der folgenden Antworten zurückgegeben:
Szenario | HTTP-Code | Code | Nachricht |
---|---|---|---|
Methode wird für Entität nicht unterstützt | 405 | methodNotAllowed | Diese Methode wird für diesen Entitätstyp nicht unterstützt. Die methoden, die für diese Entität gelten, finden Sie in der Microsoft Graph-Dokumentation. |
Der Benutzer verfügt nicht über einen geeigneten Berechtigungsbereich. | 403 | Verboten (Forbidden) | Ihr Konto hat keinen Zugriff auf diesen Bericht oder diese Daten. Wenden Sie sich an Ihren globalen Administrator, um Zugriff anzufordern. |
Verboten (Forbidden) | 403 | Verboten (Forbidden) | Sie verfügen nicht über einen geeigneten Serviceplan für diese Anforderung. |
Bad request (Ungültige Anforderung) | 400 | badRequest | Dieser Anbieter ist für den angegebenen Mandanten nicht aktiviert. |
Bad request (Ungültige Anforderung) | 400 | badRequest | Es ist ein Problem mit Ihrer Anforderung aufgetreten. Stellen Sie sicher, dass die eingegebene registrationId für Ihren Mandanten gültig oder registriert ist. |
Bad request (Ungültige Anforderung) | 404 | Notfound | Die angeforderte Zuweisungs-ID ist nicht vorhanden. |
Interner Serverfehler | 500 | internalServerError | Internal server error. (Interner Serverfehler) |
Anforderung gedrosselt | 429 | tooManyRequests | {"code": "tooManyRequests","message": "Wiederholen sie nach {noOfMinutes} Minuten"}. |
Dienst nicht verfügbar (Service Unavailable) | 503 | serviceUnavailable | {"code": "serviceUnavailable","message": "Wiederholung nach {noOfMinutes} Minuten"}. |
Beispiele
Beispiel 1: Abrufen einer Lernkursaktivität basierend auf ihrer ID
Anforderung
Die folgenden Beispiele zeigen eine Anforderung zum Abrufen einer Lernkursaktivität mithilfe einer ID.
GET https://graph.microsoft.com/v1.0/employeeExperience/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Antwort
Das folgende Beispiel zeigt die Antwort.
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"
}
Beispiel 2: Abrufen einer Lernkursaktivität basierend auf der externalCourseActivityId des Lernanbieters
Anforderung
Das folgende Beispiel zeigt eine Anforderung zum Abrufen der Details einer Lernkursaktivität mithilfe einer externen Kursaktivitäts-ID.
GET https://graph.microsoft.com/v1.0/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities(externalCourseActivityId=12a2228a-e020-11ec-9d64-0242ac120002)
Antwort
Das folgende Beispiel zeigt die Antwort.
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"
}
Beispiel 3: Abrufen der Details einer Lernkursaktivität für einen Benutzer
Anforderung
Das folgende Beispiel zeigt eine Anforderung zum Abrufen der Details einer Lernkursaktivität für einen Benutzer.
GET https://graph.microsoft.com/v1.0/users/7ba2228a-e020-11ec-9d64-0242ac120002/employeeExperience/learningCourseActivities/8ba2228a-e020-11ec-9d64-0242ac120003
Antwort
Das folgende Beispiel zeigt die Antwort.
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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für