Method: courses.topics.patch

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

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

  • PERMISSION_DENIED si le projet de développement à l'origine de la demande n'a pas créé le sujet correspondant ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si le format de la requête est incorrect.
  • NOT_FOUND si le cours ou le thème demandés n'existent pas

Requête HTTP

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

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Masque qui identifie les champs du sujet à 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 Topic. 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 Topic, une erreur INVALID_ARGUMENT est renvoyée.

Les champs suivants peuvent être spécifiés:

  • name

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

Corps de la requête

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

Corps de la réponse

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

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