Ce document contient des informations sur l'autorisation et l'authentification spécifiques à l'API Google Classroom. Avant de lire ce document, assurez-vous de consulter 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 habilitations pour définir les informations affichées aux utilisateurs et aux évaluateurs d'applications, 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 les niveaux d'autorisation. Un champ d'application d'autorisation est une chaîne URI OAuth 2.0 qui contient 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 travailler avec les données Google Workspace, y compris les données de compte Google des utilisateurs.
Lors de l'installation de votre application, l'utilisateur est invité à valider les champs d'application utilisés par l'application. En règle générale, vous devez choisir le champ d'application le plus précis possible et éviter de demander des champs d'application dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement l'accès à des niveaux d'accès 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 enseignez 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 demande pour les éléments du flux 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 tels que les devoirs, les questions et les notes. |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
Afficher vos devoirs et vos notes dans Google Classroom |
https://www.googleapis.com/auth/classroom.coursework.students
|
Gérer les notes et les devoirs des élèves dans les cours Google Classroom auxquels vous participez en tant qu'enseignant et afficher les notes et les devoirs des cours auxquels vous participez en tant qu'administrateur. |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
Afficher les notes et les devoirs des élèves dans les cours Google Classroom auxquels vous participez en tant qu'enseignant ou en tant qu'administrateur. |
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
|
Affichez 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
|
Affichez 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
|
Recevez des notifications concernant vos données Google Classroom. |
https://www.googleapis.com/auth/classroom.rosters
|
Gérez 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
|
Afficher vos devoirs et vos notes dans Google Classroom |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
Afficher les notes et les devoirs des élèves dans les cours Google Classroom auxquels vous participez en tant qu'enseignant ou en tant qu'administrateur. |
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. |