Choisir les champs d'application de l'API Google Classroom

Ce document contient des informations spécifiques sur l'autorisation et l'authentification de l'API Google Classroom. Avant de lire ce document, assurez-vous de consulter les informations générales sur l'authentification et l'autorisation de Google Workspace dans la section 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 niveaux d'accès pour définir les informations affichées pour les utilisateurs et les évaluateurs d'applications. Enregistrez ensuite votre application pour pouvoir la publier ultérieurement.

Niveaux d'accès de l'API Classroom

Pour définir le niveau d'accès accordé à votre application, vous devez identifier et déclarer des niveaux d'accès. Un niveau d'accès est une chaîne d'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 niveaux d'accès correspondent aux demandes de votre application pour utiliser les données Google Workspace, y compris les données de compte Google des utilisateurs.

Lorsqu'un utilisateur installe votre application, il est invité à valider les niveaux d'accès utilisés par l'application. En règle générale, vous devez choisir le niveau d'accès le plus spécifique possible et éviter de demander des niveaux d'accès 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 niveaux d'accès 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 demandeur aux éléments du flux dans les classes de Google Classroom où vous donnez cours
https://www.googleapis.com/auth/classroom.addons.student	Consulter et mettre à jour les pièces jointes du projet Google Cloud demandeur aux é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 Google Classroom classes.
https://www.googleapis.com/auth/classroom.courses.readonly	Consulter 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, questions et les 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 notes et les devoirs des étudiants 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 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	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 classes
https://www.googleapis.com/auth/classroom.profile.photos	Afficher les photos de profil des personnes présentes dans vos classes
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	Consulter la composition de vos classes Google Classroom
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly	Afficher vos notes et vos devoirs dans Google Classroom
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly	Afficher les notes et les devoirs des élèves dans les 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