Method: courses.updateGradingPeriodSettings

• Requête HTTP
• Paramètres de chemin d'accès
• Paramètres de requête
• Corps de la requête
• Corps de la réponse
• Champs d'application des autorisations

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui accorde un accès anticipé à certaines fonctionnalités. Cette fonctionnalité est disponible dans V1_20240401_PREVIEW et dans les versions ultérieures. Pour en savoir plus, consultez Accéder aux API Preview.

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

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

• PERMISSION_DENIED si l'utilisateur demandeur 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.