- Ressource: Cours
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- Méthodes
Ressource: Cours
un 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 Si vous spécifiez ce champ dans un masque de mise à jour du cours, une erreur est renvoyée. |
name |
Intitulé du cours. Exemple : "Biologie de terminale". Veuillez saisir un nom. Il doit comporter entre 1 et 750 caractères et une chaîne UTF-8 valide. |
section |
Section du cours. Exemple : "Période 2". S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne doit pas dépasser 2 800 caractères. |
descriptionHeading |
En-tête facultatif pour la description. Par exemple, "Bienvenue en biologie de terminale". S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne doit pas dépasser 3 600 caractères. |
description |
Description facultative. Par exemple : « Nous apprendrons la structure des créatures vivantes à partir d'une combinaison de manuels scolaires, de conférences et de travaux en laboratoire. Attendez-vous à être enthousiaste !" S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne doit pas dépasser 30 000 caractères. |
room |
Emplacement de la salle facultatif. Exemple : "301". S'il est défini, ce champ doit être une chaîne UTF-8 valide et ne doit pas dépasser 650 caractères. |
ownerId |
Identifiant du propriétaire d'un cours. Lorsqu'il est spécifié en tant que paramètre de
Vous devez définir ces valeurs dans une requête de création. Les administrateurs peuvent également spécifier ce champ dans un |
creationTime |
Heure de création du cours. Si vous spécifiez ce champ dans un masque de mise à jour du cours, une erreur est renvoyée. Lecture seule. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
updateTime |
Heure de la dernière mise à jour de ce cours. Si vous spécifiez ce champ dans un masque de mise à jour du cours, une erreur est renvoyée. Lecture seule. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
enrollmentCode |
Code d'inscription à utiliser pour rejoindre ce cours. Si vous spécifiez ce champ dans un masque de mise à jour du cours, une erreur est renvoyée. 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. Lecture seule. |
teacherGroupEmail |
Adresse e-mail d'un groupe Google contenant tous les enseignants du cours. Ce groupe n'accepte pas les e-mails et ne peut être utilisé que pour les autorisations. Lecture seule. |
courseGroupEmail |
Adresse e-mail d'un groupe Google contenant tous les membres du cours. Ce groupe n'accepte pas les e-mails et ne peut être utilisé que pour les autorisations. 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 de domaine. Lecture seule. |
courseMaterialSets[] |
Ensembles de supports de cours affichés sur la page "À propos" de ce cours Lecture seule. |
guardiansEnabled |
Indique si les notifications destinées aux représentants légaux sont activées pour ce cours. Lecture seule. |
calendarId |
ID de l'agenda d'un agenda visible par tous les membres du cours, dans lequel Classroom ajoute des événements pour les devoirs et des annonces au cours du cours. L'agenda d'un cours est créé de manière asynchrone lorsque le cours est défini sur Lecture seule. |
gradebookSettings |
Paramètres du carnet de notes qui indiquent comment la note globale d'un élève sera calculée et à qui elle sera présentée. Lecture seule |
CourseState
États possibles dans lesquels un cours peut se trouver.
Enums | |
---|---|
COURSE_STATE_UNSPECIFIED |
Aucun état du 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 le modifier, sauf pour lui attribuer un état différent. |
PROVISIONED |
Le cours a été créé, mais n'est 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é. Il est accessible par le propriétaire du cours et les administrateurs du domaine, bien qu'il ne soit pas affiché dans l'interface utilisateur Web. Vous ne pouvez pas modifier le cours, sauf pour lui attribuer 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 placé dans cet état s'il est susceptible d'enfreindre les conditions d'utilisation. |
CourseMaterialSet
Ensemble de supports qui apparaît sur la page "À propos" du cours. Ces supports peuvent inclure un programme, 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 dans le cadre 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 |
Informations sur le lien. |
form |
Pièce jointe Google Forms. |
GradebookSettings
Paramètres du carnet de notes pour 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 documents de travail du cours. |
CalculationType
Méthodes possibles pour calculer la note globale.
Enums | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
Aucune méthode spécifiée. Cet élément n'est jamais renvoyé. |
TOTAL_POINTS |
La note globale correspond à la somme des notes divisée par la somme du total des points, 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é. Cet élément n'est jamais renvoyé. |
SHOW_OVERALL_GRADE |
Affiche la note globale dans le carnet de notes et sur le profil de l'élève, pour les enseignants et les élèves. |
HIDE_OVERALL_GRADE |
La note globale n'apparaît pas 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. est masqué pour les élèves dans leur profil d'élève ; |
Méthodes |
|
---|---|
|
Indique si un utilisateur est autorisé à créer des pièces jointes de modules complémentaires dans un cours donné. |
|
Crée un cours. |
|
Supprime un cours. |
|
Renvoie un cours. |
|
Affiche une liste de cours que l'utilisateur à l'origine de la demande est autorisé à consulter, limitées à ceux qui correspondent à la requête. |
|
Met à jour un ou plusieurs champs d'un cours. |
|
Met à jour un cours. |