Method: courses.courseWorkMaterials.patch

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

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

  • PERMISSION_DENIED si le projet de développement demandeur présente des erreurs d'accès.
  • INVALID_ARGUMENT si la requête est mal formée.
  • 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}/courseWorkMaterials/{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 celui attribué par Classroom ou un alias.
id

string

Identifiant du support de cours.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Masque qui identifie les champs du support 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 les valeurs vides, il peut être effacé en le spécifiant dans le masque de mise à jour et non dans l'objet de contenu de cours. 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 de contenu de cours, une erreur INVALID_ARGUMENT est renvoyée.

Les enseignants peuvent spécifier les champs suivants :

  • title
  • description
  • state
  • scheduledTime
  • topicId

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 du point de terminaison.

PREVIEW_VERSION_9001 inclut de nouvelles fonctionnalités : * Les mises à jour des matières sont acceptées. Pour mettre à jour les matériaux, utilisez le updateMask "materials". La liste des matériaux fournie dans l'objet CourseWorkMaterial de la demande remplacera entièrement la liste existante. Le champ "materials" (matériaux) peut être effacé en spécifiant "materials" dans le masque de mise à jour et non dans l'objet CourseWorkMaterial. Les modifications apportées aux CourseWorkMaterial PUBLIÉS ne sont pas acceptées pour le moment.

Corps de la requête

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

Corps de la réponse

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

Pour en savoir plus, consultez le guide d'autorisation.