Method: courses.courseWork.rubrics.patch

• Requête HTTP
• Paramètres de chemin d'accès
• Paramètres de requête
• Corps de la requête
• Corps de la réponse
• Champs d'application des autorisations

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui accorde un accès anticipé à certaines fonctionnalités. Cette fonctionnalité est disponible dans V1_20231110_PREVIEW et les versions ultérieures. Pour en savoir plus, consultez la section API Access Preview.

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
Important : Si vous créez une grille d'évaluation à partir d'une feuille de calcul Google Sheets en spécifiant le sourceSpreadsheetId, des champs d'application supplémentaires (https://www.googleapis.com/auth/spreadsheets.readonly ou https://www.googleapis.com/auth/spreadsheets) sont nécessaires. Notez que les champs d'application de spreadsheets sont considérés comme sensibles et peuvent nécessiter la validation de votre application.

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