Utilisateurs éligibles

Bien que tout développeur puisse envoyer des requêtes à l'API Google Classroom, certaines fonctionnalités de Google Classroom ne sont disponibles que pour certains utilisateurs. Chaque fonctionnalité peut avoir des exigences différentes, comme un certain type de licence Google Workspace for Education. Pour obtenir une description détaillée des fonctionnalités de 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 modules complémentaires Classroom
• Modifier les paramètres des périodes de notation
• Créer, modifier et supprimer des rubriques

Déterminer les capacité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 capacités appropriées avant d'envoyer des requêtes d'API avec des critères d'éligibilité.

Pour déterminer si un utilisateur dispose d'une fonctionnalité particulière, envoyez une requête API à la méthode checkUserCapability. Incluez le type Capability approprié pour la fonctionnalité Classroom que vous souhaitez 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 défini sur true, l'utilisateur a accès à l'Capability choisi. Vous pouvez ensuite envoyer des requêtes API liées à Capability au nom de l'utilisateur.