EducationAssignment abrufen
Namespace: microsoft.graph
Ruft die Eigenschaften und Beziehungen einer Zuweisung ab. Nur Lehrkräfte, Kursteilnehmer und Anwendungen mit Anwendungsberechtigungen können diesen Vorgang ausführen.
Die Kursteilnehmer können nur aufgaben sehen, die ihnen zugewiesen sind; Lehrkräfte und Anwendungen mit Anwendungsberechtigungen können alle Aufgaben in einem Kurs sehen.
Sie können den Prefer
-Header in Ihrer Anforderung verwenden, um die inactive
status abzurufen, falls die Zuweisung deaktiviert ist. Andernfalls ist unknownFutureValue
der Antwortwert für die status-Eigenschaft .
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) | EduAssignments.ReadBasic | EduAssignments.Read, EduAssignments.ReadWrite, EduAssignments.ReadWriteBasic |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | EduAssignments.ReadBasic.All | EduAssignments.Read.All, EduAssignments.ReadWrite.All, EduAssignments.ReadWriteBasic.All |
HTTP-Anforderung
GET /education/classes/{id}/assignments/{id}
Optionale Abfrageparameter
Diese Methode unterstützt die $select
OData-Abfrageparameter und $expand
zum Anpassen der Antwort. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Sie können mit den folgenden Navigationseigenschaften der EducationAssignment-Ressource verwenden$expand
: categories, resources, rubric, submissions, and gradingCategory. Sie können auch verwenden *
, um alle Navigationseigenschaften anzugeben.
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Prefer | include-unknown-enum-members. Optional. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK
Antwortcode und ein educationAssignment-Objekt im Antworttext zurück.
Beispiele
Beispiel 1: Abrufen einer Bildungsaufgabe
Das folgende Beispiel zeigt, wie Sie eine educationAssignment-Anweisung abrufen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/c0f133b9-615c-4119-876c-c1848fd0a99a
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 279
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments/$entity",
"classId": "37d99af7-cfc5-4e3b-8566-f7d40e4a2070",
"displayName": "Inactive assignment",
"closeDateTime": null,
"dueDateTime": "2024-03-30T18:29:00Z",
"assignDateTime": null,
"assignedDateTime": "2024-02-13T14:41:07.9250378Z",
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"feedbackResourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ7ONF5UOYTXZVEKCZE43FTQRH2S",
"createdDateTime": "2024-02-13T14:40:43.8825959Z",
"lastModifiedDateTime": "2024-02-13T15:12:14.6154569Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "assigned",
"notificationChannelUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%22c0f133b9-615c-4119-876c-c1848fd0a99a%5C%22%5D%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22assignment-viewer%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"addToCalendarAction": "none",
"addedStudentAction": "none",
"moduleUrl": null,
"id": "c0f133b9-615c-4119-876c-c1848fd0a99a",
"instructions": {
"content": "",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "00000003-0000-0000-c000-000000000000",
"displayName": null
}
}
}
Beispiel 2: Abrufen einer Zuweisung im inaktiven Zustand mit dem optionalen Prefer-Header
Das folgende Beispiel zeigt, wie Sie eine inactive
Zuweisung mithilfe des optionalen Prefer
Headers abrufen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/1a9404ca-08c9-4e29-8ac8-4cd36e8188ea/
Prefer: include-unknown-enum-members
Antwort
Das folgende Beispiel zeigt die Antwort mit status, wenn inactive
Prefer: include-unknown-enum-members
im Anforderungsheader angegeben wird.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments/$entity",
"classId": "37d99af7-cfc5-4e3b-8566-f7d40e4a2070",
"displayName": "2024-01-25T19:55:40.174Z8003",
"closeDateTime": null,
"dueDateTime": "2024-02-24T19:55:40.174Z",
"assignDateTime": null,
"assignedDateTime": "2024-01-25T19:55:49.6601453Z",
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"feedbackResourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ7ONF5UOYTXZVEKCZE43FTQRH2S",
"createdDateTime": "2024-01-25T19:55:40.409873Z",
"lastModifiedDateTime": "2024-02-15T03:55:48.9013742Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "inactive",
"notificationChannelUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%221a9404ca-08c9-4e29-8ac8-4cd36e8188ea%5C%22%5D%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22assignment-viewer%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"addToCalendarAction": "none",
"addedStudentAction": "none",
"moduleUrl": null,
"id": "1a9404ca-08c9-4e29-8ac8-4cd36e8188ea",
"instructions": {
"content": "2023-12-13T20_53_54_999Z",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "fadaae59-b18c-44d1-993f-fe8a281bd69c",
"displayName": null
}
}
}
Beispiel 3: Abrufen einer Zuweisung im inaktiven Zustand ohne den optionalen Prefer-Header
Das folgende Beispiel zeigt, wie Eine inactive
Zuweisung ohne den optionalen Prefer
Header abgerufen wird.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/c0f133b9-615c-4119-876c-c1848fd0a99a/
Antwort
Das folgende Beispiel zeigt die Antwort mit status, wenn unknownFutureValue
Prefer: include-unknown-enum-members
nicht im Anforderungsheader angegeben wird.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments/$entity",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/assignments('<guid>')?$select=addedStudentAction,addToCalendarAction",
"classId": "37d99af7-cfc5-4e3b-8566-f7d40e4a2070",
"displayName": "Inactive assignment",
"closeDateTime": null,
"dueDateTime": "2024-03-30T18:29:00Z",
"assignDateTime": null,
"assignedDateTime": "2024-02-13T14:41:07.9250378Z",
"allowLateSubmissions": true,
"resourcesFolderUrl": null,
"feedbackResourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ7ONF5UOYTXZVEKCZE43FTQRH2S",
"createdDateTime": "2024-02-13T14:40:43.8825959Z",
"lastModifiedDateTime": "2024-02-15T03:47:11.4792693Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "unknownFutureValue",
"notificationChannelUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%22c0f133b9-615c-4119-876c-c1848fd0a99a%5C%22%5D%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22assignment-viewer%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"addToCalendarAction": "none",
"addedStudentAction": "none",
"moduleUrl": null,
"id": "c0f133b9-615c-4119-876c-c1848fd0a99a",
"instructions": {
"content": "",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "fadaae59-b18c-44d1-993f-fe8a281bd69c",
"displayName": null
}
}
}