Répertorier les résultats
Espace de noms: microsoft.graph
Récupérez une liste d’objets educationOutcome . Il existe quatre types de résultats : educationPointsOutcome, educationFeedbackOutcome, educationRubricOutcome et educationFeedbackResourceOutcome. Seuls les enseignants, les étudiants et les applications disposant d’autorisations d’application peuvent effectuer cette opération.
Une soumission pour une affectation de crédit (une qui n’a pas de valeur de point ni de rubrique) a un educationFeedbackOutcome. (Il peut également renvoyer un educationPointsOutcome, mais ce résultat est ignoré.)
Une soumission pour un devoir de points (qui a une valeur de point affectée) a à la fois un educationFeedbackOutcome et un educationPointsOutcome.
Une soumission pour un devoir avec une rubrique jointe, si la rubrique est une rubrique de crédit (aucun point), a un educationFeedbackOutcome et un educationRubricOutcome. (Il peut également renvoyer un educationPointsOutcome, mais ce résultat est ignoré.)
Une soumission pour un devoir avec une rubrique jointe, si la rubrique est une rubrique de points, a un educationFeedbackOutcome, un educationPointsOutcome et un educationRubricOutcome.
Une soumission pour une ressource de commentaires a un educationFeedbackResourceOutcome.
Tous les types de résultats ont une propriété régulière et une propriété publiée appropriée pour ce type de résultat ; par exemple, points et points publiés, commentaires et publishedFeedback. La propriété régulière est la valeur la plus récente mise à jour par l’enseignant ; la propriété publiée est la valeur la plus récente retournée à l’étudiant.
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) | EduAssignments.Read | EduAssignments.ReadWrite |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | EduAssignments.Read.All | EduAssignments.ReadWrite.All |
Requête HTTP
GET /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes
Paramètres facultatifs de la requête
Cette méthode prend en charge les $top
paramètres de requête OData , $filter
et $select
pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.
Toutes les propriétés sont prises en charge pour les paramètres $filter
de requête et $orderby
.
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 une collection d’objets educationOutcome dans le corps de la réponse.
Exemples
Exemple 1 : Obtenir tous les résultats
L’exemple suivant montre comment récupérer tous les résultats.
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/outcomes
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('bf1f1963-05f6-4cba-903c-5892b4ce3bd7')/assignments('db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a')/submissions('4bca096a-7de3-8675-5e86-2fa149923860')/outcomes",
"value": [
{
"@odata.type": "#microsoft.graph.educationFeedbackOutcome",
"lastModifiedDateTime": null,
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
"lastModifiedBy": null,
"feedback": null,
"publishedFeedback": null
},
{
"@odata.type": "#microsoft.graph.educationPointsOutcome",
"lastModifiedDateTime": null,
"id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
"lastModifiedBy": null,
"points": null,
"publishedPoints": null
},
{
"@odata.type": "#microsoft.graph.educationRubricOutcome",
"lastModifiedDateTime": "2024-08-14T05:47:41.8399565Z",
"id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"rubricQualityFeedback": [
{
"qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
"feedback": null
},
{
"qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
"feedback": null
},
{
"qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
"feedback": null
}
],
"rubricQualitySelectedLevels": [
{
"qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
"columnId": null
},
{
"qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
"columnId": null
},
{
"qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
"columnId": null
}
],
"publishedRubricQualityFeedback": [
{
"qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
"feedback": null
},
{
"qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
"feedback": null
},
{
"qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
"feedback": null
}
],
"publishedRubricQualitySelectedLevels": [
{
"qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
"columnId": null
},
{
"qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
"columnId": null
},
{
"qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
"columnId": null
}
]
}
]
}
Exemple 2 : Obtenir les résultats filtrés par type de résultat
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/a3cce0ba-2008-4c4d-bf62-079408562d96/submissions/2185e6d7-2924-4ed1-dde1-269f89e29184/outcomes?$filter=isof('microsoft.graph.educationFeedbackResourceOutcome')
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
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('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes",
"@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>')/submissions('<guid>')/outcomes?$select=lastModifiedBy,lastModifiedDateTime",
"value": [
{
"@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
"lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
"id": "0710aeea-590d-46b4-9eb8-1c08b6549677",
"resourceStatus": "notPublished",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
},
"feedbackResource": {
"@odata.type": "#microsoft.graph.educationWordResource",
"displayName": "Document3.docx",
"createdDateTime": "2022-05-06T00:52:17.3180176Z",
"lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
"fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ563EMEMHRTBBH2SOZ4GDSNEUZK",
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
}
}
},
{
"@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
"lastModifiedDateTime": "2022-05-06T00:52:21.8011514Z",
"id": "4176c991-c263-4772-9b01-5a27d55e123e",
"resourceStatus": "notPublished",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
},
"feedbackResource": {
"@odata.type": "#microsoft.graph.educationWordResource",
"displayName": "Document4.docx",
"createdDateTime": "2022-05-06T00:52:21.8011302Z",
"lastModifiedDateTime": "2022-05-06T00:52:21.8011514Z",
"fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ3OHVMMZAEQPRC3LQJLBEQQY4BI",
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
}
}
}
]
}
Exemple 3 : Utilisation $orderby
de pour obtenir des résultats
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/a3cce0ba-2008-4c4d-bf62-079408562d96/submissions/2185e6d7-2924-4ed1-dde1-269f89e29184/outcomes?$orderby=id
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
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('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes",
"value": [
{
"@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
"lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
"id": "0710aeea-590d-46b4-9eb8-1c08b6549677",
"resourceStatus": "notPublished",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
},
"feedbackResource": {
"@odata.type": "#microsoft.graph.educationWordResource",
"displayName": "Document3.docx",
"createdDateTime": "2022-05-06T00:52:17.3180176Z",
"lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
"fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ563EMEMHRTBBH2SOZ4GDSNEUZK",
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
"displayName": null
}
}
}
}
]
}