- Ressource: Cours
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- CourseState
- CourseMaterialSet
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- CourseMaterial
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- GradebookSettings
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- CalculationType
- DisplaySetting
- Méthodes
Ressource: Cours
Cours dans Classroom.
Représentation JSON |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
Champs | |
---|---|
id |
Identifiant de ce cours attribué par Classroom. Si la valeur est La spécification de ce champ dans un masque de mise à jour de cours génère une erreur. |
name |
Nom du cours. Exemple : "Biologie de 1re". Veuillez saisir un nom. Il doit comporter entre 1 et 750 caractères, et une chaîne UTF-8 valide. |
section |
section du cours. (par exemple, "Période 2"). S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne pas dépasser 2 800 caractères. |
descriptionHeading |
En-tête facultatif pour la description. Par exemple, "Bienvenue en biologie de 2de". S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne pas dépasser 3 600 caractères. |
description |
Description facultative. Par exemple : "Nous allons découvrir la structure des créatures vivantes grâce à un ensemble de manuels scolaires, de conférences organisées par des invités et de travaux de laboratoire. Attendez-vous à être enthousiaste !" S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne pas dépasser 30 000 caractères. |
room |
Emplacement facultatif de la salle. Exemple : "301". S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne pas dépasser 650 caractères. |
ownerId |
Identifiant du propriétaire d'un cours. Lorsqu'il est spécifié en tant que paramètre d'un élément
Vous devez définir ce paramètre dans une requête de création. Les administrateurs peuvent également spécifier ce champ dans un |
creationTime |
Heure de création du cours. La spécification de ce champ dans un masque de mise à jour de cours génère une erreur. En lecture seule. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
updateTime |
Heure de la dernière mise à jour de ce cours. La spécification de ce champ dans un masque de mise à jour de cours génère une erreur. En lecture seule. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
enrollmentCode |
Code d'inscription à utiliser pour rejoindre ce cours. La spécification de ce champ dans un masque de mise à jour de cours génère une erreur. En lecture seule. |
courseState |
État du cours Si aucune valeur n'est spécifiée, l'état par défaut est |
alternateLink |
Lien absolu vers ce cours dans l'interface utilisateur Web de Classroom. En lecture seule. |
teacherGroupEmail |
Adresse e-mail d'un groupe Google incluant tous les enseignants du cours. Ce groupe n'accepte pas les e-mails et ne peut être utilisé que pour les autorisations. En lecture seule. |
courseGroupEmail |
Adresse e-mail d'un groupe Google incluant tous les membres du cours. Ce groupe n'accepte pas les e-mails et ne peut être utilisé que pour les autorisations. En lecture seule. |
teacherFolder |
Informations sur un dossier Drive partagé avec tous les enseignants du cours. Ce champ ne sera défini que pour les enseignants du cours et les administrateurs du domaine. En lecture seule. |
courseMaterialSets[] |
Ensembles de supports apparaissant sur la page "À propos" de ce cours. En lecture seule. |
guardiansEnabled |
Indique si les notifications destinées aux représentants légaux sont activées pour ce cours. En lecture seule. |
calendarId |
ID de l'agenda d'un agenda visible par tous les membres du cours, auquel Classroom ajoute des événements liés aux devoirs et des annonces du cours. L'agenda d'un cours est créé de manière asynchrone lorsque le cours est défini sur En lecture seule. |
gradebookSettings |
Les paramètres du carnet de notes qui spécifient comment la note globale d'un élève pour le cours sera calculée et à qui elle sera affichée. Lecture seule |
CourseState
États possibles d'un cours.
Enums | |
---|---|
COURSE_STATE_UNSPECIFIED |
Aucun état de cours. Aucun message de cours renvoyé n'utilisera cette valeur. |
ACTIVE |
Le cours est actif. |
ARCHIVED |
Le cours a été archivé. Vous ne pouvez pas la modifier, sauf pour la changer d'état. |
PROVISIONED |
Le cours a été créé, mais pas encore activé. Il est accessible par l'enseignant principal et les administrateurs du domaine, qui peuvent le modifier, ou lui attribuer l'état ACTIVE ou DECLINED . Un cours ne peut être remplacé par PROVISIONED que s'il est à l'état DECLINED . |
DECLINED |
Le cours a été créé, mais a été refusé. Le propriétaire du cours et les administrateurs du domaine peuvent y accéder, mais il ne s'affiche pas dans l'interface utilisateur Web. Vous ne pouvez pas modifier le cours, sauf pour le faire passer à l'état PROVISIONED . Un cours ne peut être remplacé par DECLINED que s'il est à l'état PROVISIONED . |
SUSPENDED |
Le cours a été suspendu. Vous ne pouvez pas modifier le cours, et seul l'utilisateur identifié par le ownerId peut le consulter. Un cours peut être associé à cet état s'il est susceptible d'enfreindre les conditions d'utilisation. |
CourseMaterialSet
Un ensemble de supports qui apparaît sur la page "À propos" du cours. Il peut s'agir d'un programme, d'un calendrier ou d'autres informations générales concernant le cours dans son ensemble.
Représentation JSON |
---|
{
"title": string,
"materials": [
{
object ( |
Champs | |
---|---|
title |
Titre de cet ensemble. |
materials[] |
Supports de cours associés à cet ensemble. |
CourseMaterial
Support de cours associé à un cours faisant partie d'un ensemble de supports.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union material . Données Material. material ne peut être qu'un des éléments suivants : |
|
driveFile |
Fichier Google Drive en pièce jointe. |
youTubeVideo |
Vidéo YouTube en pièce jointe. |
link |
Lien d'association. |
form |
Pièce jointe Google Forms. |
GradebookSettings
Paramètres du carnet de notes d'un cours. Pour en savoir plus, consultez cet article du Centre d'aide.
Représentation JSON |
---|
{ "calculationType": enum ( |
Champs | |
---|---|
calculationType |
Indique comment la note globale est calculée. |
displaySetting |
Indique qui peut voir la note globale. |
gradeCategories[] |
Catégories de notes disponibles pour les travaux et devoirs du cours. |
CalculationType
Méthodes possibles pour calculer la note globale
Enums | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
Aucune méthode spécifiée. Cette valeur n'est jamais renvoyée. |
TOTAL_POINTS |
La note globale correspond à la somme des notes divisée par la somme des points totaux, quelle que soit la catégorie. |
WEIGHTED_CATEGORIES |
La note globale correspond à la moyenne pondérée par catégorie. |
DisplaySetting
Paramètres possibles pour l'affichage de la note globale.
Enums | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
Aucun paramètre spécifié. Cette valeur n'est jamais renvoyée. |
SHOW_OVERALL_GRADE |
Indique aux enseignants et aux élèves la note globale dans le carnet de notes et le profil de l'élève. |
HIDE_OVERALL_GRADE |
N'affiche pas la note globale dans le carnet de notes ni dans le profil de l'élève. |
SHOW_TEACHERS_ONLY |
Affiche la note globale aux enseignants dans le carnet de notes et le profil de l'élève. ne s'affiche pas dans le profil des élèves. |
Méthodes |
|
---|---|
|
Indique si un utilisateur est autorisé à créer des pièces jointes de module complémentaire dans un cours donné. |
|
Indique si un utilisateur peut mettre à jour les paramètres GradingPeriodSettings dans un cours donné. |
|
Crée un cours. |
|
Supprime un cours. |
|
Renvoie un cours. |
|
Affiche les paramètres de la période de notation d'un cours. |
|
Affiche la liste des cours que l'utilisateur à l'origine de la requête est autorisé à consulter, limités à ceux qui correspondent à la requête. |
|
Met à jour un ou plusieurs champs dans un cours. |
|
Met à jour un cours. |
|
Met à jour les paramètres de la période de notation d'un cours. |