Method: courses.courseWork.patch

Met à jour un ou plusieurs champs d'un devoir de cours.

Pour en savoir plus sur les champs pouvant être mis à jour et sur les personnes autorisées à les modifier, consultez google.classroom.v1.CourseWork.

Cette demande doit être effectuée par le projet Developer Console associé à l'ID client OAuth utilisé pour créer l'élément de travail du 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 de cours correspondant, si l'utilisateur n'est pas autorisé à apporter la modification demandée au travail de l'élève ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si le format de la requête est incorrect.
  • FAILED_PRECONDITION si le devoir demandé a déjà été supprimé.
  • NOT_FOUND si le cours ou le devoir demandé n'existe pas.

Requête HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{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.
id

string

Identifiant du devoir de cours.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Masque qui identifie les champs du devoir de cours à mettre à jour. Ce champ est obligatoire pour effectuer une mise à jour. La mise à jour échoue si des champs non valides sont spécifiés. Si un champ accepte des valeurs vides, vous pouvez l'effacer en le spécifiant dans le masque de mise à jour et non dans l'objet CourseWork. Si un champ qui n'accepte pas les valeurs vides est inclus dans le masque de mise à jour et n'est pas défini dans l'objet CourseWork, une erreur INVALID_ARGUMENT est renvoyée.

Les enseignants peuvent spécifier les champs suivants:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Disponible dans V1_20240401_PREVIEW et versions ultérieures.

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. Il doit être défini 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 de CourseWork.

Corps de la réponse

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

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.