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 conditions différentes, par exemple avoir un certain type de licence Google Workspace for Education. Pour obtenir une description détaillée des fonctionnalités disponibles pour 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
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'envoyer des requêtes API avec des critères d'éligibilité.
Pour déterminer si un utilisateur possède une fonctionnalité 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 a accès à un module complémentaire Classroom appartenant au projet Google Cloud à l'origine de la requête, transmettez la valeur
CREATE_ADD_ON_ATTACHMENT. - Pour voir si l'utilisateur peut modifier les paramètres de la période de notation, transmettez
UPDATE_GRADING_PERIOD_SETTINGS.
Vérifiez ensuite le champ allowed dans la réponse. Si allowed correspond à true, l'utilisateur a accès à l'Capability choisie. Vous pouvez ensuite effectuer des requêtes API liées au Capability pour le compte de l'utilisateur.