Method: courses.updateGradingPeriodSettings

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

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 concernant 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 d'un cours ou en cas d'erreurs d'accès:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT si le format de la requête est incorrect.
  • 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 des paramètres GradingPeriodSettings à mettre à jour.

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

  • Les périodes de notation incluses dans la liste sans identifiant sont considérées comme des ajouts, et un nouvel identifiant sera attribué lorsque la requête sera effectuée.
  • Les périodes de notation qui existent actuellement, mais qui ne figurent pas dans la demande, seront considérées comme des suppressions.
  • Les périodes de notation associées à un ID existant et à des données modifiées sont considérées comme des modifications. Les données non modifiées sont laissées telles quelles.
  • Les périodes de notation incluses avec un identifiant inconnu généreront une erreur.

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

  • 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. 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 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 relatif aux autorisations.