Cette page contient des informations sur les fonctionnalités à venir de l'API Classroom et explique comment participer à la version Preview développeur.
Prévisualiser l'API Classroom
La prévisualisation des fonctionnalités de l'API Classroom permet aux développeurs d'influencer le développement des fonctionnalités grâce à leurs commentaires et de préparer les intégrations pour une utilisation publique avant la disponibilité générale.
Cycle de vie de la version Preview
Les développeurs peuvent choisir d'utiliser des versions de l'API contenant de nouvelles fonctionnalités rétrocompatibles. Ces "versions Preview" sont disponibles publiquement pendant au moins 90 jours. En fonction des commentaires, la version Preview et ses fonctionnalités sont ensuite intégrées à l'API v1 existante. Les versions Preview restent disponibles pendant au moins 90 jours supplémentaires avant d'être arrêtées.
Si les commentaires sur une version Preview sont suffisamment importants pour nécessiter des modifications majeures, une nouvelle version est créée pour prendre en charge les fonctionnalités existantes. Les deux versions sont disponibles pendant au moins 90 jours pour permettre la migration des développeurs. Rejoignez la liste de diffusion de la version Preview développeur de l'API Classroom pour vous tenir informé des modifications apportées à la version Preview et abonnez-vous à la liste d'annonces pour obtenir des informations plus générales sur les mises à jour de l'API Classroom.
Participer aux versions Preview de l'API Classroom
Pour participer, rejoignez le programme Preview développeur Google Workspace. Les fonctionnalités disponibles en version Preview publique sont listées dans les versions Preview développeur actives de Google Workspace. Si vous testez une fonctionnalité en version Preview privée, il est possible qu'elle ne soit pas listée dans la documentation publique.
Fonctionnalités à venir
Voici notre feuille de route des fonctionnalités d'API attendues et de leurs délais. Elle est mise à jour régulièrement.
La valeur de la version Preview représente la date prévue pour la disponibilité initiale de la version Preview. Consultez Accéder aux API en version Preview pour découvrir comment utiliser les versions Preview sont utilisées.
| Fonctionnalité | Description | Cible pour la version Preview | Cible pour la disponibilité générale | Version Preview |
|---|---|---|---|---|
| Fonctionnalités utilisateur | Vérifiez si un utilisateur a accès à certaines fonctionnalités Classroom. | T4 2024 | S1 2025 | V1_20240930_PREVIEW |
| Objectifs d'apprentissage | Définissez des normes d'apprentissage pour les cours et des objectifs d'apprentissage pour les devoirs et les grilles d'évaluation. | T3 2026 | T4 2026 | V1_20260316_PREVIEW |
Versions précédentes
Une fois les nouvelles fonctionnalités validées, elles sont intégrées à l'API v1 et la version Preview correspondante est arrêtée. Les développeurs disposent d'au moins 90 jours pour effectuer la migration avant l'arrêt de la version Preview.
| Fonctionnalité | Description | Intégrée à la disponibilité générale | Date cible d'arrêt de la version Preview | Version Preview |
|---|---|---|---|---|
| CRUD pour les grilles d'évaluation | Créez, lisez, mettez à jour et supprimez des grilles d'évaluation Classroom au nom des enseignants. | 5 décembre 2024 | 1er avril 2025 | V1_20231110_PREVIEW |
| Périodes de notation | Créez, lisez, mettez à jour et supprimez des périodes de notation au nom des administrateurs et des enseignants. | 8 avril 2025 | 1er août 2025 | V1_20240401_PREVIEW |
| Groupes d'élèves | Gérez les groupes d'élèves et leurs membres au nom des administrateurs et des enseignants. | 26 janvier 2026 | 1er juin 2026 | V1_20250630_PREVIEW |
Conseils de migration
Une fois les fonctionnalités d'une version Preview intégrées à l'API v1, supprimez l'argument previewVersion des appels d'API associés pour vous assurer que votre application continue de se comporter comme prévu. Par exemple, si vous accédiez aux fonctionnalités de création de grilles d'évaluation introduites dans la version V1_20231110_PREVIEW, vos appels d'API peuvent se présenter comme suit :
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
# Specify the preview version. Rubrics CRUD capabilities are
# supported in V1_20231110_PREVIEW and later.
previewVersion="V1_20231110_PREVIEW"
).execute()
Pour migrer vers l'API v1 en disponibilité générale, supprimez l'argument previewVersion :
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Si vous utilisiez une bibliothèque cliente générée de manière statique spécifiquement pour accéder à une fonctionnalité de version Preview donnée et que vous n'utilisez pas d'autres fonctionnalités d'API en version Preview, passez à la bibliothèque cliente par défaut pour votre langage. Pour en savoir plus, consultez Accéder aux API en version Preview.
Commentaires
Partagez vos commentaires sur les fonctionnalités en version Preview via l'IssueTracker associé dans la section "Versions Preview développeur actives" de la page de présentation du programme Preview développeur Google Workspace.
Utiliser les fonctionnalités en version Preview de l'API Classroom en production
Si vous souhaitez utiliser les fonctionnalités en version Preview de l'API Classroom avec des utilisateurs finaux, y compris des enseignants, des administrateurs ou des élèves réels, vous devez accepter un amendement spécifique à Classroom aux conditions d'utilisation du programme Preview développeur Google Workspace Google Workspace en remplissant et en envoyant ce formulaire :