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

Ce document contient des informations d'autorisation et d'authentification spécifiques à l'API Google Classroom. Avant de lire ce document, veillez à lire les informations générales d'authentification et d'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 champs d'application pour définir les informations à présenter aux utilisateurs et aux examinateurs 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 des champs d'application d'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 auquel elle accède et le niveau d'accès. Les champs d'application correspondent aux demandes d'utilisation des données Google Workspace par votre application, y compris les données des comptes Google des utilisateurs.

Lorsque votre application est installée, 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 champs d'application limités et clairement décrits.

L'API Classroom accepte les champs d'application suivants:

Niveaux d'accès Signification
https://www.googleapis.com/auth/classroom.announcements Affichez et gérez les annonces dans Google Classroom.
https://www.googleapis.com/auth/classroom.announcements.readonly Affichez 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 consulter 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 devoirs et vos notes 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 auxquels vous participez en tant qu'enseignant, et afficher les devoirs et les notes des cours que vous administrez.
https://www.googleapis.com/auth/classroom.coursework.students.readonly Afficher les devoirs et les notes des élèves dans les cours Google Classroom auxquels vous participez en tant qu'enseignant ou que vous gérez
https://www.googleapis.com/auth/classroom.courseworkmaterials Consultez, modifiez et créez des travaux et devoirs dans Google Classroom.
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly Consultez tous les travaux et devoirs pour vos cours Google Classroom.
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly Afficher vos représentants légaux Google Classroom.
https://www.googleapis.com/auth/classroom.guardianlinks.students Affichez et gérez les représentants légaux des élèves de vos cours Google Classroom.
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly Affichez 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 participant à 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 cours Google Classroom.
https://www.googleapis.com/auth/classroom.rosters.readonly afficher la composition de vos cours 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 devoirs et les notes des élèves dans les cours Google Classroom auxquels vous participez en tant qu'enseignant ou que vous gérez
https://www.googleapis.com/auth/classroom.topics Consultez, créez et modifiez des thèmes dans Google Classroom.
https://www.googleapis.com/auth/classroom.topics.readonly afficher les thèmes dans Google Classroom ;