Mettre à jour educationRubric
Espace de noms: microsoft.graph
Mettez à jour les propriétés d’un objet educationRubric . Seuls les enseignants peuvent effectuer cette opération.
La mise à jour d’une rubrique attachée à une affectation (PATCH /education/classes/{class-id}/assignments/{assignment-id}/rubric) n’est possible qu’avant la publication de l’affectation, et ce qui est mis à jour est en fait la rubrique d’origine qui existe sous /education/users/{id}/rubrics. Une fois l’affectation publiée, une copie immuable de la rubrique est effectuée, jointe à cette affectation spécifique. Cette rubrique peut être récupérée à l’aide de GET /education/classes/{class-id}/assignments/{assignment-id}/rubric, mais elle ne peut pas être mise à jour.
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.ReadWriteBasic | EduAssignments.ReadWrite |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | Non prise en charge. | Non prise en charge. |
Requête HTTP
PATCH /education/me/rubrics/{id}
PATCH /education/classes/{id}/assignments/{id}/rubric
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
Dans le corps de la demande, fournissez les valeurs pour les champs appropriés qui doivent être mis à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas été modifiées.
| Propriété | Type | Description |
|---|---|---|
| description | itemBody | Description de cette rubrique. |
| displayName | Chaîne | Nom de cette rubrique. |
| classement | educationAssignmentGradeType | Type de notation de la rubrique.
null pour une rubrique sans points et educationAssignmentPointsGradeType pour une rubrique avec des points. |
| Niveaux | collection rubricLevel | Collection de niveaux qui composent cette rubrique. |
| glorieux | collection rubricQuality | Collection de qualités qui composent cette rubrique. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet educationRubric mis à jour dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
PATCH https://graph.microsoft.com/v1.0/education/me/rubrics/5f650796-a600-4d20-87ef-c46ae34da3bb
Content-type: application/json
{
"displayName": "Example Credit Rubric after display name patch"
}
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/me/rubrics/$entity",
"displayName": "Example Credit Rubric after display name patch",
"createdDateTime": "2024-07-17T00:21:14.4479093Z",
"lastModifiedDateTime": "2024-07-17T15:00:08.5062776Z",
"id": "5f650796-a600-4d20-87ef-c46ae34da3bb",
"description": {
"content": "New Rubric",
"contentType": "text"
},
"qualities": [
{
"qualityId": "bdde7fc5-9a0b-4db7-9103-aeb6d4d20fbd",
"displayName": null,
"weight": 33.33,
"description": {
"content": "First quality",
"contentType": "text"
},
"criteria": [
{
"description": {
"content": "First quality is excellent",
"contentType": "text"
}
},
{
"description": {
"content": "First quality is good",
"contentType": "text"
}
},
{
"description": {
"content": "First quality is fair",
"contentType": "text"
}
},
{
"description": {
"content": "First quality is poor",
"contentType": "text"
}
}
]
}
],
"levels": [
{
"levelId": "f0b16138-3ab2-4712-bbe0-b0a2653017a1",
"displayName": "Excellent",
"description": {
"content": "",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 4
}
},
{
"levelId": "f5b1cc98-a22e-44d6-8e20-a29fb7de4860",
"displayName": "Good",
"description": {
"content": "",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 3
}
},
{
"levelId": "352dfa9f-0ad3-42c5-a7b7-843dc78d83f9",
"displayName": "Fair",
"description": {
"content": "",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 2
}
},
{
"levelId": "b1d9ac8f-fb57-4172-9863-4a4994bc31fa",
"displayName": "Poor",
"description": {
"content": "",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 1
}
}
],
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
}
}