Bien que tout développeur puisse envoyer des requêtes à l'API Google Classroom, certaines fonctionnalités Google Classroom ne sont disponibles que pour certains utilisateurs. Chaque fonctionnalité peut avoir des exigences différentes, comme un type de licence Google Workspace for Education spécifique. Pour obtenir un récapitulatif détaillé des fonctionnalités disponibles à chaque niveau de licence Google Workspace for Education, consultez la page de comparaison des éditions.
Fonctionnalités soumises à des critères d'éligibilité
Les fonctionnalités suivantes de l'API Classroom ne sont disponibles que pour les utilisateurs éligibles:
- Créer et modifier des pièces jointes de module complémentaire Classroom
- Modifier les paramètres de la période de notation
- Créer, modifier et supprimer des rubriques
Déterminer les fonctionnalités de l'utilisateur
Les requêtes envoyées à l'API Classroom sont effectuées au nom d'utilisateurs individuels. Par conséquent, vous devez vérifier si un utilisateur dispose des fonctionnalités appropriées avant d'envoyer des requêtes d'API avec des conditions d'éligibilité.
Pour déterminer si un utilisateur dispose d'une capacité particulière, envoyez une requête API à la méthode checkUserCapability. Incluez le type Capability approprié pour la fonctionnalité Classroom que vous prévoyez d'utiliser. Spécifiez le Capability approprié pour chaque fonctionnalité:
| Pour savoir si l'utilisateur... | Capability |
|---|---|
| Peut créer ou modifier une pièce jointe de module complémentaire Classroom associée au projet Google Cloud de l'ID client OAuth utilisé pour envoyer la requête | CREATE_ADD_ON_ATTACHMENT |
| Peut modifier les paramètres des périodes de notation | UPDATE_GRADING_PERIOD_SETTINGS |
| Peut créer, modifier ou supprimer une grille d'évaluation | CREATE_RUBRIC |
Ensuite, vérifiez le champ allowed dans la réponse. Si allowed est true, l'utilisateur a accès à l'Capability choisie. Vous pouvez ensuite effectuer des requêtes d'API liées à Capability au nom de l'utilisateur.