Method: courses.courseWork.studentSubmissions.patch

Met à jour un ou plusieurs champs d'un devoir d'élève.

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

Cette requête doit être effectuée par le projet de la console développeur de l'ID client OAuth utilisé pour créer l'élément de devoir correspondant ou une pièce jointe de module complémentaire avec la synchronisation des notes activée sur l'élément de devoir correspondant.

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

  • PERMISSION_DENIED si le projet de développeur demandeur n'a pas créé le devoir correspondant ou une pièce jointe de module complémentaire sur le devoir correspondant avec la synchronisation des notes activée, si l'utilisateur n'est pas autorisé à apporter la modification demandée au devoir de l'élève ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si la requête est mal formée.
  • NOT_FOUND si le cours, le devoir ou le devoir de l'élève demandé 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. Cet identifiant peut être l'identifiant attribué par Classroom ou un alias.
courseWorkId

string

Identifiant du devoir.
id

string

Identifiant du devoir de l'élève.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Masque qui identifie les champs du devoir de l'élève à 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 champs suivants peuvent être spécifiés par les enseignants :

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

Facultatif. Version preview de l'API. Vous devez définir cette valeur pour accéder aux nouvelles fonctionnalités de l'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 de StudentSubmission.

Corps de la réponse

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

Niveaux d'accès 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 sur l'autorisation.