Ce document contient des informations sur l'autorisation et l'authentification spécifiques à l'API Google Classroom. Avant de lire ce document, consultez les informations générales sur l'authentification et l'autorisation dans Google Workspace sur la page En savoir plus sur l'authentification et l'autorisation.
Configurer OAuth 2.0 pour l'autorisation
Configurez l'écran de consentement OAuth et choisissez des autorisations pour définir les informations qui s'affichent auprès des utilisateurs et des examinateurs de l'application, et enregistrez votre application pour pouvoir la publier ultérieurement.
Champs d'application de l'API Classroom
Pour définir le niveau d'accès accordé à votre application, vous devez identifier et déclarer des champs d'application de l'autorisation. Un champ d'application d'autorisation est une chaîne d'URI OAuth 2.0 contenant le nom de l'application Google Workspace, le type de données auxquelles elle accède et le niveau d'accès. Les champs d'application correspondent aux demandes de votre application pour utiliser les données Google Workspace, y compris les données du compte Google des utilisateurs.
Lorsque votre application est installée, un utilisateur est invité à valider les champs d'application qu'elle utilise. En règle générale, vous devez choisir le champ d'application le plus ciblé possible et éviter de demander des niveaux d'accès dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement un accès à des champs d'application limités et clairement décrits.
L'API Classroom est compatible avec les champs d'application suivants:
| Niveaux d'accès | Signification |
|---|---|
https://www.googleapis.com/auth/classroom.addons.teacher
|
Consulter, créer et mettre à jour les pièces jointes du projet Google Cloud à l'origine de la demande pour diffuser des éléments dans les cours que vous donnez dans Google Classroom |
https://www.googleapis.com/auth/classroom.addons.student
|
Consulter et mettre à jour les pièces jointes du projet Google Cloud à l'origine de la requête pour diffuser des éléments dans Google Classroom |
https://www.googleapis.com/auth/classroom.announcements
|
Afficher et gérer les annonces dans Google Classroom |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
Afficher les annonces dans Google Classroom |
https://www.googleapis.com/auth/classroom.courses
|
Consulter, modifier, créer et supprimer définitivement vos cours Google Classroom |
https://www.googleapis.com/auth/classroom.courses.readonly
|
Consultez vos cours Google Classroom. |
https://www.googleapis.com/auth/classroom.coursework.me
|
Consulter, créer et modifier des éléments de cours, y compris des devoirs, des questions et des notes. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Afficher vos notes et vos devoirs dans Google Classroom |
https://www.googleapis.com/auth/classroom.coursework.students
|
Gérer les devoirs et les notes des élèves dans les cours Google Classroom que vous enseignez, et afficher les devoirs et les notes des cours que vous gérez |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Affichez les notes et les devoirs des élèves dans les cours Google Classroom que vous enseignez ou gérez. |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
Consulter, modifier et créer des travaux et devoirs dans Google Classroom |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
Consulter l'ensemble des travaux et devoirs pour vos cours Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
Afficher les représentants légaux de vos élèves Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
Afficher et gérer les représentants légaux des élèves de vos cours Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
Afficher les représentants légaux des élèves de vos cours Google Classroom |
https://www.googleapis.com/auth/classroom.profile.emails
|
Afficher les adresses e-mail des personnes présentes dans vos cours. |
https://www.googleapis.com/auth/classroom.profile.photos
|
afficher les photos de profil des personnes présentes dans vos cours ; |
https://www.googleapis.com/auth/classroom.push-notifications
|
Recevoir des notifications concernant vos données Google Classroom |
https://www.googleapis.com/auth/classroom.rosters
|
Gérer la composition de vos classes Google Classroom |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
Consultez la composition de vos classes Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
Consultez vos devoirs et vos notes dans Google Classroom. |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Affichez les notes et les devoirs des élèves dans les cours Google Classroom que vous enseignez ou gérez. |
https://www.googleapis.com/auth/classroom.topics
|
Afficher, créer et modifier des thèmes dans Google Classroom |
https://www.googleapis.com/auth/classroom.topics.readonly
|
Afficher les thèmes dans Google Classroom |