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 des pièces jointes de module complémentaire Classroom
- Modifier les paramètres de la période de notation
- Créer, mettre à jour et supprimer des grilles d'évaluation
Déterminer les fonctionnalités disponibles pour 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'émettre 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 |
---|---|
Accès à un module complémentaire Classroom appartenant au projet Google Cloud à l'origine de la demande | CREATE_ADD_ON_ATTACHMENT |
Peut modifier les paramètres des périodes de notation | UPDATE_GRADING_PERIOD_SETTINGS |
Peut créer ou modifier une grille d'évaluation | CREATE_RUBRIC |
Ensuite, vérifiez le champ allowed
dans la réponse. Si allowed
correspond à true
, l'utilisateur a accès à l'Capability
choisie. Vous pouvez ensuite envoyer des requêtes d'API liées à Capability
au nom de l'utilisateur.