Method: courses.updateGradingPeriodSettings

Met à jour les paramètres de période de notation d'un cours.

Vous pouvez ajouter, supprimer ou modifier des périodes de notation individuelles à l'aide de cette méthode.

L'utilisateur demandeur et le propriétaire du cours doivent être autorisés à modifier les périodes de notation. Pour en savoir plus, consultez les conditions requises pour les licences.

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

  • PERMISSION_DENIED si l'utilisateur à l'origine de la demande n'est pas autorisé à modifier les paramètres de la période de notation dans un cours ou en cas d'erreurs d'accès :
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT si la requête est incorrecte.
  • NOT_FOUND si le cours demandé n'existe pas.

Requête HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Obligatoire. Identifiant du cours.

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Masque qui identifie les champs de GradingPeriodSettings à mettre à jour.

La liste gradingPeriods GradingPeriodSettings sera entièrement remplacée par les périodes de notation spécifiées dans la requête de mise à jour. Exemple :

  • Les périodes de notation incluses dans la liste sans ID sont considérées comme des ajouts. Un nouvel ID leur sera attribué lors de la demande.
  • Les périodes de notation qui existent actuellement, mais qui ne figurent pas dans la requête, seront considérées comme des suppressions.
  • Les périodes de notation avec un ID existant et des données modifiées sont considérées comme des modifications. Les données non modifiées resteront telles quelles.
  • Les périodes de notation incluses avec un ID inconnu génèrent une erreur.

Vous pouvez spécifier les champs suivants:

  • gradingPeriods
  • applyToExistingCoursework

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. Ce paramètre 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 GradingPeriodSettings.

Corps de la réponse

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

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