Configuration d'un projet Google Cloud

Cette page contient les informations dont vous avez besoin pour créer et configurer des projets Google Cloud pour les modules complémentaires Classroom. Les projets Google Cloud permettent d'implémenter l'authentification unique Google via OAuth 2.0 (authentification unique Google), d'autoriser les requêtes effectuées par votre module complémentaire et de gérer la fiche d'un module complémentaire sur la place de marché Google Workspace.

Pour en savoir plus sur la publication d'un module complémentaire sur la place de marché, consultez Publier une application.

Création de projets Google Cloud

Important :La visibilité publique doit être définie dans le SDK Google Workspace Marketplace pour votre application de module complémentaire de production. Un projet privé peut être utile pour développer et tester votre module complémentaire, mais seul un projet public est requis.

Vous pouvez créer deux types de projets: un projet privé utilisé pour le développement et un projet public accessible par les utilisateurs finaux. Les libellés "public" et "privé" font référence à la visibilité de votre application dans Google Workspace Marketplace. Une application Marketplace privée ne peut être installée que par les utilisateurs du domaine dans lequel elle a été créée, tandis qu'une application Marketplace publique est disponible pour tous les domaines Google Workspace. Il doit s'agir de deux applications distinctes, car un projet ne peut pas être à la fois public et privé. Les applications publiques doivent être examinées et approuvées avant d'être disponibles sur la place de marché.

Important :Vous ne pouvez pas convertir un projet privé en projet public.

Pour obtenir des informations générales sur la création d'un projet Google Cloud, consultez la page Créer un projet Google Cloud.

Créer un projet Google Cloud public

Ce projet représente l'application complémentaire accessible aux administrateurs, aux enseignants et aux élèves. Un projet public doit être examiné et approuvé par l'équipe Google Workspace Marketplace avant de pouvoir être lancé ou installé.

1. Créez un projet Google Cloud dans votre domaine de production.

   Créer un projet Google Cloud

   Important:Assurez-vous que le projet appartient à votre domaine de production et que vous êtes connecté à la console Google Cloud en tant qu'utilisateur de ce domaine.
   Avertissement:Vous devez utiliser la version Brouillon de votre projet pour les tests. Pour le moment, la fonctionnalité Brouillon n'est disponible que via le programme Preview développeur Google Workspace. Après avoir créé votre projet Cloud, remplissez le formulaire de demande pour activer les fonctionnalités du programme Google Workspace Developer Preview. Pour en savoir plus, consultez Mettre à jour la fiche de votre application avec des brouillons.

2. Activez l'API Classroom dans votre projet Cloud.

   Activer l'API Classroom

3. Activez le SDK Google Workspace Marketplace dans votre projet Cloud.

   Activer le SDK Google Workspace Marketplace

4. Définissez la configuration de l'application Visibilité de l'application du SDK Marketplace sur Publique et cochez la case Non répertoriée.

   Important:Vous ne pouvez pas partager ni convertir un projet privé utilisé lors du développement et des tests internes.
   Important:Les applications non listées ne peuvent pas être trouvées sur Google Workspace Marketplace en parcourant ou en recherchant. Dans la configuration du SDK Marketplace, vous trouverez une URL directe que vous pouvez utiliser pour installer le module complémentaire. Seuls Google et le développeur peuvent trouver la fiche Play Store. Votre application doit rester non répertoriée jusqu'à ce que vous soyez prêt à la rendre disponible au grand public. Vous pouvez activer ou désactiver l'affichage d'un module complémentaire sur la page "Configuration de l'application" du SDK Marketplace.

5. Renseignez les champs obligatoires sur la page Fiches Play Store du SDK Marketplace, puis cliquez sur PUBLISH (PUBLIER).

6. Votre application sera examinée par l'équipe Google Workspace Marketplace. Il vous contactera à l'aide de l'adresse e-mail du développeur indiquée dans le SDK de la place de marché. Une fois l'application approuvée, décochez la case Non répertoriée pour que les enseignants et les administrateurs puissent la trouver sur Marketplace.

Créer un projet Google Cloud privé

Ce projet privé représente l'application complémentaire utilisée pour le développement. Elle n'est pas accessible aux utilisateurs en dehors du domaine dans lequel elle a été créée, mais elle n'a pas besoin d'être approuvée avant l'installation. Par conséquent, Google vous recommande d'utiliser ce projet pour développer et tester votre module complémentaire dans un environnement contrôlé.

Pour créer un projet privé, vous devez accéder à un domaine Google Workspace for Education avec la licence Teaching and Learning ou Plus. Si vous n'avez pas encore accès à un tel domaine, suivez ces étapes pour configurer un domaine de démonstration Google Workspace for Education, le mettre à niveau vers une licence Plus et lui autoriser l'accès à l'API des modules complémentaires Classroom:

1. Suivez la procédure permettant d'obtenir un domaine test de développeur.

2. Une fois connecté en tant qu'administrateur dans le domaine de démonstration, créez un projet Google Cloud.

   Créer un projet Google Cloud

   Avertissement :Assurez-vous que le projet appartient au domaine de démonstration et que vous êtes connecté à la console Google Cloud à l'aide d'un compte administrateur de ce domaine.

   Si vous ne parvenez pas à accéder à la console Google Cloud ni à créer de projets Cloud, vérifiez les points suivants dans la console d'administration:

   • Accédez à la page Paramètres du compte > Paramètres d'accès basés sur l'âge, puis sélectionnez l'option Tous les utilisateurs de ce groupe ou de cette unité organisationnelle ont au moins 18 ans.
   • Sous Applications > Services Google supplémentaires:
   • Google Cloud Platform est activé pour tous.
   • Les paramètres de création de projets sont Autoriser les utilisateurs à créer des projets.
   • Les paramètres d'accès à Cloud Shell sont Autoriser l'accès à Cloud Shell.

3. Remplissez et envoyez le formulaire de demande de mise à niveau du domaine de démonstration. En envoyant ce formulaire, vous demandez à Google de passer votre domaine de démonstration à Google Workspace for Education Plus avec dix licences et d'autoriser votre projet Cloud à accéder à l'API des modules complémentaires Classroom.

   Vous recevrez un e-mail une fois les processus de mise à niveau et d'ajout à la liste d'autorisation terminés. Attribuez des licences Plus à vos comptes enseignant test dans la console d'administration. Sous Annuaire > Utilisateurs, créez ou sélectionnez vos comptes enseignant test. Dans la section Licences de chaque enseignant, vérifiez que Google Workspace for Education Plus est attribué.

4. Activez l'API Classroom dans votre projet Cloud.

   Activer l'API Classroom

5. Activez le SDK Google Workspace Marketplace dans votre projet Cloud.

   Activer le SDK Google Workspace Marketplace

6. Définissez la configuration de l'application et la visibilité de l'application du SDK Marketplace sur privé.

7. Renseignez les champs obligatoires sur la page Fiche Play Store du SDK Marketplace, puis cliquez sur PUBLISH. Une fois la fiche de l'application publiée, les utilisateurs du domaine peuvent la rechercher et l'installer dans Google Workspace Marketplace ou en accédant à l'URL de l'application indiquée sur la page de fiche Play Store.

OAuth 2.0

L'accès à l'API Classroom nécessite l'autorisation de l'utilisateur à accéder à ses données. Pour les obtenir, demandez à Google d'accéder aux habilitations OAuth pour l'utilisateur connecté et recevez un jeton qui peut être utilisé pour effectuer ultérieurement des appels d'API à Google Classroom. Les champs d'application doivent être configurés dans la fiche Google Workspace Marketplace afin que l'administrateur de domaine puisse donner son consentement au nom des utilisateurs de son domaine s'ils installent le module complémentaire.

Important :Si votre module complémentaire demande des niveaux d'accès supplémentaires, incluez-les sur l'écran d'autorisation OAuth, dans l'onglet "Configuration de l'application du SDK Marketplace" et dans le code d'application de votre module complémentaire. Les champs d'application incompatibles dans ces emplacements peuvent entraîner des problèmes pour les utilisateurs lors de l'installation du module complémentaire.

Étant donné que les niveaux d'accès Classroom sont sensibles, vous devez demander une validation OAuth avant de lancer votre module complémentaire. Sinon, les utilisateurs verront un message d'avertissement indiquant que l'application n'est pas validée, et seuls un petit nombre d'utilisateurs pourront accéder à votre produit. Pour en savoir plus sur la validation, consultez la présentation de la séquence d'examen.

Avertissement :Si vous utilisez un projet Google Cloud existant pour développer un module complémentaire, ne demandez pas les nouveaux champs d'application dans le code pour les produits existants qu'après la validation. Utilisez un flux d'autorisation distinct, un environnement de test ou définissez un flag de fonctionnalité pour ne demander ces champs d'application que pour les routes associées à vos modules complémentaires avant de terminer la validation.

Consultez la page Champs d'application OAuth pour les API Google pour obtenir la liste détaillée de tous les champs d'application disponibles et de leurs utilisations. Pour en savoir plus sur la configuration OAuth, consultez la page Configurer OAuth dans la documentation Workspace.

Autorisations utilisateur

Votre application Web doit demander au moins l'un des niveaux d'accès suivants:

• https://www.googleapis.com/auth/userinfo.email, qui permet à une application d'afficher l'adresse e-mail de l'utilisateur.
• https://www.googleapis.com/auth/userinfo.profile, qui permet à une application d'afficher des informations personnelles telles que le portrait, le prénom et le nom, ainsi que d'autres informations personnelles que l'utilisateur a rendues publiques.

Une fois qu'un utilisateur a autorisé l'un de ces champs d'application dans votre module complémentaire, il est identifié par le paramètre de requête login_hint. Ce paramètre est transmis à l'une des URL de votre application Web lorsqu'un iFrame est ouvert. Si un utilisateur n'a pas autorisé l'un de ces champs d'application, login_hint ne sera pas envoyé.

Avertissement :Votre application doit demander au moins l'un des champs d'application userinfo.email ou userinfo.profile pour recevoir login_hint lors des visites ultérieures du même utilisateur.

login_hint est un paramètre OpenID Connect standard que vous pouvez transmettre à Google lorsque vous utilisez Google Sign-In ou demandez un jeton OAuth. Il vise à fluidifier l'expérience d'autorisation pour l'utilisateur final.

Champs d'application des modules complémentaires Classroom

Les champs d'application suivants sont spécifiques aux modules complémentaires Classroom:

• https://www.googleapis.com/auth/classroom.addons.teacher, qui permet d'accéder à toutes les méthodes de l'API.
• https://www.googleapis.com/auth/classroom.addons.student, qui permet d'accéder à la validation de lancement et aux opérations de lecture des pièces jointes.

Même avec un jeton d'accès OAuth valide indiquant les identifiants de l'utilisateur, les appels d'API sont soumis à des exigences supplémentaires:

• Toutes les méthodes nécessitent que l'utilisateur soit enseignant ou élève dans le cours spécifié par le courseId de la requête.
• Pour créer, mettre à jour, supprimer et transmettre des notes, l'utilisateur doit être enseignant.
• Les appels à un post Google Classroom spécifique sont soumis aux vérifications suivantes.
  • Lorsqu'un module complémentaire dispose déjà d'au moins une pièce jointe sur un post, il peut effectuer des requêtes pour :
    • Validation du lancement d'iFrame
    • Opérations de lecture, de mise à jour et de suppression des pièces jointes
    • Noter les mises à jour sur ce post
  • Lorsque l'iframe de découverte des pièces jointes s'ouvre pour la première fois, il est possible que le module complémentaire n'ait pas encore de pièce jointe sur le post. Un paramètre de requête addOnToken est fourni et peut être utilisé pour envoyer des requêtes pour les éléments suivants :
    • Créer une pièce jointe sous le post (addOnToken est obligatoire)
    • Lancer la validation (addOnToken est validé s'il est fourni et est requis lorsque le module complémentaire ne comporte pas de pièce jointe au post)

Validation OAuth

Remarque :Vous ne pouvez pas créer de vidéo de démonstration à envoyer dans le cadre du processus de validation OAuth. À la place, publiez le module complémentaire sans valider OAuth. L'équipe d'examen Google Workspace Marketplace sera alors alertée et créera une vidéo de démonstration en votre nom. L'équipe d'examinateurs vous fournit ensuite la vidéo afin que vous puissiez l'inclure dans votre demande de validation OAuth.

Les modules complémentaires Classroom accèdent aux données des utilisateurs Google à l'aide des API Google.

• Validez votre identité de marque.
• Validez les champs d'application OAuth sensibles.

Pour en savoir plus sur la procédure de validation, consultez les questions fréquentes sur la validation de l'API OAuth.

Fiche Google Workspace Marketplace

Avertissement :Une fois que vous avez enregistré votre option de visibilité lors du processus de publication, vous ne pouvez plus modifier votre sélection.

Pour obtenir des informations générales sur la configuration du SDK Google Workspace Marketplace, consultez Activer et configurer le SDK Google Workspace Marketplace et Créer une fiche Play Store Google Workspace Marketplace.

Considérations concernant les fiches

La liste de magasins des SDK Marketplace de votre projet Google Cloud public spécifie le nom de votre application et les descriptions destinées aux utilisateurs finaux. Vous pouvez fournir ces informations dans plusieurs langues sous Informations sur l'application.

Suivez ces consignes dans vos fiches:

• Sous Informations sur l'application:

  • Évitez d'utiliser des signes de ponctuation dans le nom de l'application. Par exemple, utilisez Mon module complémentaire par Ma société au lieu de "Ma société: Mon module complémentaire" ou "Mon module complémentaire, par Ma société".

  • Les champs Short Description (Description courte) et verbose Description (Description détaillée) ne doivent pas contenir exactement le même texte.

  + Assurez-vous d'avoir sélectionné une valeur pour le champ Pricing (Tarification). Ce champ inclut les options Sans frais, Payant avec un essai sans frais, Payant avec des fonctionnalités sans frais et Payant. Vous n'avez pas besoin de spécifier le montant du coût dans la fiche Marketplace.

  • Assurez-vous d'avoir sélectionné une valeur pour le champ Catégorie. Les modules complémentaires Classroom peuvent être de bons choix pour les ressources pédagogiques et les outils pour les enseignants et les administrateurs.

  • Pour en savoir plus, consultez les éléments listés dans la description des détails de l'application de Marketplace.

Important :Consultez les détails de l'application pour chaque langue dans laquelle vous proposez votre module complémentaire.

• Sous Éléments graphiques:

  • Les éléments graphiques fournis ne sont pas flous et respectent les tailles spécifiées dans les normes de Google Workspace Marketplace.

  • Les captures d'écran fournies sont des représentations précises de votre expérience avec le module complémentaire.

• Sous Liens d'assistance:

  • Assurez-vous d'avoir fourni un lien vers les Conditions d'utilisation de votre application.

• Vérifiez que vous respectez les Consignes relatives à la marque des API Google, qui couvrent les noms et les descriptions autorisés.

• Si vous faites référence à des produits Google dans votre fiche, utilisez leur nom dans le format indiqué dans la liste des marques. Assurez-vous d'inclure le symbole de marque (™) si spécifié. Utilisez Google Docs™, et non "Google Docs".

Intégration aux services de gestion des licences et de facturation de Google

Si vous souhaitez intégrer vos applications Google Workspace Marketplace aux services de licence et de facturation de Google, consultez la API Marketplace.

Paramètres d'installation

Les modules complémentaires peuvent permettre une installation individuelle en plus de l'installation par un administrateur. Cette page met en évidence certaines différences entre les deux types d'installation. Elle n'a pas vocation à promouvoir l'un ou l'autre type d'installation. Vous pouvez choisir d'autoriser ou non l'installation individuelle sur la page de configuration de l'application du SDK Google Workspace Marketplace.

Installation par l'administrateur

Les installations par un administrateur permettent à un administrateur d'ajouter un module complémentaire à tous les comptes d'un domaine, ou à des groupes d'accès ou des unités organisationnelles spécifiques. Seul un administrateur de domaine peut effectuer une installation administrateur. L'administrateur peut éventuellement accepter tous les champs d'application d'accès au nom de tous les utilisateurs du domaine. Les utilisateurs ne sont pas invités à accepter les champs d'application d'accès si l'administrateur choisit de le faire.

Voici quelques éléments à prendre en compte concernant l'installation par l'administrateur.

• Contrôles plus stricts Les administrateurs peuvent limiter les utilisateurs autorisés à accéder à un module complémentaire.
• Compatibilité avec les licences Si votre application nécessite une licence, la gestion des installations par un administrateur peut aider à garantir que les licences sont distribuées et utilisées correctement avec l'établissement correspondant.
• Réduire la charge pour les utilisateurs finaux Une installation par un administrateur réduit la charge de configuration pour les enseignants et les élèves. Cela peut offrir une expérience utilisateur plus fluide, avec moins de clics et moins de risques de confusion.

Pour découvrir comment effectuer des installations par administrateur, consultez Installer des applications Marketplace dans votre domaine. Pour en savoir plus sur les unités organisationnelles et les groupes d'accès, consultez Fonctionnement de la structure organisationnelle.

Installation individuelle

Les installations individuelles ajoutent un module complémentaire au compte de l'utilisateur. L'utilisateur est invité à accepter les champs d'application du module complémentaire lors de l'installation.

Voici quelques points à prendre en compte pour l'installation individuelle.

• Faciliter l'adoption Plus d'utilisateurs peuvent voir et installer votre module complémentaire depuis Google Workspace Marketplace. Autoriser l'installation individuelle peut inciter davantage d'enseignants à adopter votre produit ou à en faire la promotion.
• Tests administrateur. Un administrateur peut installer individuellement un module complémentaire pour le tester ou l'évaluer avant de l'approuver ou de l'installer pour un groupe plus large.

En plus d'installer des modules complémentaires pour le compte des utilisateurs, les administrateurs peuvent également gérer une liste d'autorisation pour permettre aux utilisateurs d'installer des modules complémentaires permettant une installation individuelle. Si un module complémentaire ne figure pas dans la liste d'autorisation, les utilisateurs peuvent toujours voir sa fiche dans Google Workspace Marketplace, mais ne peuvent pas l'installer. À la place, un message leur indique que l'installation du module complémentaire n'a pas été autorisée par un administrateur de domaine. Pour en savoir plus sur ce comportement, consultez Gérer les applications Google Workspace Marketplace figurant sur votre liste d'autorisation.

Pour en savoir plus, consultez la documentation sur les paramètres d'installation de Google Workspace Marketplace.

Intégration d'une application

Vous devez fournir une URL d'iframe de lancement dans le champ URI de configuration de la pièce jointe. Cette URL est utilisée comme valeur src de l'iframe pour l'iframe de découverte des pièces jointes. L'iFrame de découverte de pièces jointes permet aux enseignants de rechercher du contenu ou des activités à joindre à leur devoir.

Vous devez également spécifier tous les préfixes d'URI à partir desquels les rattachements sont autorisés à partir de votre module complémentaire. Cette fonctionnalité renforce la sécurité en empêchant les pièces jointes provenant de sources non autorisées.

Pour en savoir plus sur ces champs, consultez le guide sur les cadres iFrame.

Comptes de test

Créez des comptes de test sur votre domaine de démonstration pour vérifier le bon fonctionnement de votre module complémentaire privé. Deux comptes élève sont nécessaires pour tester le passage d'un élève à un autre dans l'iFrame de révision des devoirs des élèves.

Comptes de test suggérés:

• Thomas, enseignant, tammy.Teacher@<votre domaine de démonstration>
• Sam Étudiant, sam.student@<votre domaine de démonstration>
• Sally Étudiante, sally.etudiante@<votre domaine de démonstration>

Pour créer un compte de test, procédez comme suit:

1. Connectez-vous à la console d'administration.
2. Accédez à Utilisateurs.
3. Cliquez sur Ajouter un utilisateur (voir figure 1).
4. Saisissez les informations de l'utilisateur et attribuez-lui les rôles appropriés.

Figure 1 Emplacement du lien Ajouter un utilisateur dans la console d'administration.

Pour créer un groupe de test, procédez comme suit:

1. Connectez-vous à la console d'administration.
2. Accédez à Groupes.
3. Cliquez sur Créer un groupe (voir figure 2).
4. Saisissez les membres et les propriétaires du groupe.

Figure 2 Emplacement du lien Créer un groupe dans la console d'administration.