Method: courses.courseWork.studentSubmissions.patch

Met à jour un ou plusieurs champs du devoir envoyé par un élève.

Consultez google.classroom.v1.StudentSubmission pour savoir quels champs peuvent être mis à jour et qui peut les modifier.

Cette demande doit être effectuée par le projet Console pour les développeurs de l'ID client OAuth utilisé pour créer le devoir de cours correspondant.

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

  • PERMISSION_DENIED si le projet de développeur à 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 l'envoi de l'élève ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si le format de la requête est incorrect.
  • NOT_FOUND si le cours demandé, le devoir ou le devoir envoyé par l'élève n'existe pas.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Identifiant du cours. Il peut s'agir de l'identifiant attribué par Classroom ou d'un alias.
courseWorkId

string

Identifiant du devoir.
id

string

Identifiant de l'envoi de l'élève.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Masque qui identifie les champs du devoir à mettre à jour. Ce champ est obligatoire pour effectuer une mise à jour. La mise à jour échoue si des champs non valides sont spécifiés.

Les enseignants peuvent spécifier les champs suivants:

  • draftGrade
  • assignedGrade

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 StudentSubmission.

Corps de la réponse

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

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

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