Method: courses.courseWorkMaterials.patch

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

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

  • PERMISSION_DENIED si le projet de développeur demandeur présente des erreurs d'accès.
  • INVALID_ARGUMENT si la requête est mal formée.
  • FAILED_PRECONDITION si le support de cours demandé a déjà été supprimé.
  • NOT_FOUND si le cours ou le support de cours 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, mais pas dans l'objet de support 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 support de cours, une erreur INVALID_ARGUMENT est renvoyée.

Les champs suivants peuvent être spécifiés par les enseignants :

  • title
  • description
  • state
  • scheduledTime
  • topicId
  • learningGoals

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 supports sont acceptées. Pour mettre à jour les supports, utilisez le masque de mise à jour "materials". La liste des supports fournie dans l'objet CourseWorkMaterial de la requête remplacera entièrement la liste existante. Le champ "materials" peut être effacé en spécifiant "materials" dans le masque de mise à jour, mais pas dans l'objet CourseWorkMaterial. Les mises à jour des 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 sur l'autorisation.