Method: courses.courseWork.rubrics.patch

Met à jour une grille d'évaluation.

Pour en savoir plus sur les champs pouvant être mis à jour, consultez la section google.classroom.v1.Rubric. Une fois que la notation a commencé, les fonctionnalités de mise à jour de la grille d'évaluation sont limitées.

Cette demande doit être effectuée par la console Google Cloud de l'ID client OAuth utilisé pour créer l'élément de travail du cours parent.

Cette méthode renvoie les codes d'erreur suivants:

  • PERMISSION_DENIED si le projet de développement à l'origine de la demande n'a pas créé le devoir correspondant, si l'utilisateur n'est pas autorisé à effectuer la modification demandée dans la grille d'évaluation, ou en cas d'erreurs d'accès. Ce code d'erreur est également renvoyé si la notation a déjà commencé dans la grille d'évaluation.
  • INVALID_ARGUMENT si le format de la requête est incorrect et pour l'erreur de requête suivante :
    • RubricCriteriaInvalidFormat
  • NOT_FOUND si le cours, le devoir ou la grille d'évaluation demandés n'existent pas, ou si l'utilisateur n'a pas accès au devoir correspondant.
  • INTERNAL si la notation a déjà commencé dans la grille d'évaluation.

Requête HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Obligatoire. Identifiant du cours.
courseWorkId

string

Obligatoire. Identifiant du devoir.
id

string

Facultatif. Identifiant de la grille d'évaluation.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Facultatif. Masque qui identifie les champs de la grille d'évaluation à mettre à jour. Ce champ est obligatoire pour effectuer une mise à jour. La mise à jour échoue si des champs non valides sont spécifiés. Plusieurs options permettent de définir les critères d'une grille d'évaluation: la liste sourceSpreadsheetId et la liste criteria. Une seule de ces options peut être utilisée à la fois pour définir une grille d'évaluation.

La liste criteria de la grille d'évaluation est entièrement remplacée par les critères spécifiés dans la demande de mise à jour. Par exemple, si un critère ou un niveau ne figure pas dans la demande, il est supprimé. De nouveaux critères et niveaux sont ajoutés, et un identifiant est attribué. Les critères et niveaux existants conservent l'ID précédemment attribué, si celui-ci est spécifié dans la demande.

Les enseignants peuvent spécifier les champs suivants:

  • criteria
  • sourceSpreadsheetId

Il s'agit d'une liste de noms complets de champs séparés par une virgule. Exemple : "user.displayName,photo"
previewVersion

enum (PreviewVersion)

Facultatif. Version preview de l'API. Vous devez définir ce paramètre pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.

Corps de la requête

Le corps de la requête contient une instance Rubric.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Rubric.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/classroom.coursework.students

Pour en savoir plus, consultez le guide relatif aux autorisations.