Cette page contient des informations sur les prochaines fonctionnalités de l'API Classroom et explique comment participer à la preview pour les développeurs.
Aperçu de l'API Classroom
Prévisualiser les fonctionnalités de l'API Classroom permet aux développeurs d'influencer le développement des fonctionnalités en fournissant des commentaires et de préparer les intégrations pour un usage public avant la disponibilité générale.
Cycle de vie de l'aperçu
Les développeurs peuvent activer les versions de l'API qui contiennent de nouvelles fonctionnalités rétrocompatibles. Ces "versions Preview" sont disponibles publiquement pendant au moins 90 jours. En fonction des commentaires reçus, la version preview et ses fonctionnalités sont ensuite intégrées à l'API v1 existante. Les versions Preview resteront disponibles pendant au moins 90 jours avant d'être arrêtées.
Si les commentaires sur une version Preview sont suffisamment importants pour nécessiter des modifications destructives, 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 aux développeurs de migrer. Rejoignez la liste de diffusion Aperçu pour les développeurs de l'API Classroom pour rester informé des modifications apportées à l'aperçu et abonnez-vous à la liste d'annonces pour obtenir des informations plus générales sur 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 actives pour les développeurs de Google Workspace. Si vous testez une fonctionnalité en aperçu privé, il est possible qu'elle ne figure pas dans la documentation publique.
Fonctionnalités à venir
Il s'agit de notre feuille de route des fonctionnalités d'API prévues et de leurs délais. Elle est mise à jour périodiquement.
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.
| Fonctionnalité | Description | Cible pour l'aperçu | Cible pour GA | Preview Version |
|---|---|---|---|---|
| Fonctionnalités utilisateur | Vérifiez si un utilisateur a accès à certaines fonctionnalités Classroom. | T4 2024 | S1 2025 | V1_20240930_PREVIEW |
| Groupes d'élèves | Gérer les groupes d'élèves et leurs membres au nom des administrateurs et des enseignants. | T3 2025 | À déterminer | À déterminer |
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égration à GA | Date d'arrêt de l'aperçu ciblé | Preview Version |
|---|---|---|---|---|
| CRUD pour les grilles d'évaluation | créer, lire, mettre à jour et supprimer des grilles d'évaluation Classroom au nom des enseignants ; | 2024-12-05 | 1er avril 2025 | V1_20231110_PREVIEW |
| Périodes de notation | créer, lire, mettre à jour et supprimer des périodes de notation au nom des administrateurs et des enseignants ; | 8 avril 2025 | 1er août 2025 | V1_20240401_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 rubriques introduites dans la version V1_20231110_PREVIEW, vos appels d'API pouvaient ressembler à ce qui 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 GA, 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é d'une version Preview donnée et que vous n'utilisez pas d'autres fonctionnalités de l'API 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 preview via l'outil IssueTracker associé dans la section Aperçus actifs pour les développeurs de la page de présentation du programme Google Workspace Developer Preview.
Utiliser les fonctionnalités en preview de l'API Classroom en production
Si vous souhaitez utiliser les fonctionnalités 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 avenant spécifique à Classroom aux Conditions du programme Preview développeur Google Workspace en remplissant et en envoyant ce formulaire :