Parcours du développeur

Voici un aperçu rapide des étapes à suivre pour développer un module complémentaire Classroom.

Important : Abonnez-vous au groupe Annonces pour les développeurs Google for Education pour recevoir des informations sur les modules complémentaires et l'API Google Classroom.

Intégration

1. Vous aurez besoin d'utilisateurs test disposant des éditions Teaching & Learning ou Plus de Google Workspace for Education. Si vous n'avez pas accès administrateur à un domaine Google Workspace for Education avec l'une de ces licences, suivez les étapes pour obtenir un domaine de test pour les développeurs, puis envoyez notre formulaire de demande de mise à niveau du domaine. Le domaine sera provisionné avec 10 licences Google Workspace for Education Plus.
2. Configurez votre domaine de test pour autoriser les utilisateurs à installer toutes les applications Marketplace. Vous pourrez ainsi installer et tester votre application avant sa publication. Si vous souhaitez tester le processus d'installation de l'application avec des paramètres de domaine plus restrictifs, vous pouvez modifier ce paramètre après avoir publié votre application.
3. Créez des comptes enseignant et élève pour les tests. Une fois la licence est approuvée pour votre domaine de démonstration, attribuez des licences à chacun de vos comptes de test.

4. Créez un projet Google Cloud. Vous l'utiliserez pour configurer votre module complémentaire, effectuer des requêtes API, et authentifier et autoriser les utilisateurs. Vous pouvez également utiliser un projet Cloud existant.

   Avertissement : Portez une attention particulière à la visibilité de l'application. Ce paramètre détermine si votre module complémentaire sera accessible aux utilisateurs finaux et ne peut pas être modifié ultérieurement.

5. Configurez OAuth pour votre projet.

6. Créez une fiche Google Workspace Marketplace pour le projet de démonstration.

   • Si vous définissez la visibilité de l'application sur Public, ajoutez les adresses e-mail de tous les utilisateurs test à la liste des testeurs brouillons. Lorsque vous avez terminé, cliquez sur ENREGISTRER LE BROUILLON.
   Point clé : Un projet à l'état brouillon vous permet de prévisualiser et de tester les modifications avant de les publier. Pour en savoir plus sur cette fonctionnalité, consultez Mettre à jour la fiche de votre application avec des brouillons pour plus d'informations sur cette fonctionnalité.

7. Connectez-vous à votre domaine de démonstration en tant qu'utilisateur test. Installez votre module complémentaire à partir de l'URL de l'application dans la configuration de votre fiche Google Workspace Marketplace.

Développement

7. Développez le module complémentaire et testez-le avec vos utilisateurs test.

Publication

8. Dans le projet Google Cloud que vous souhaitez publier, assurez-vous des points suivants :
   1. Écran de consentement OAuth :
      1. Type d'utilisateur : Externe
      2. État de la publication : En production
      3. Habilitations : configurez toutes les habilitations demandées par l'application Web.
   2. Écran de configuration de l'application du SDK Google Workspace Marketplace :
      1. Visibilité de l'application : Public
      2. Type de fiche : Non listée
      3. Habilitations : configurez toutes les habilitations demandées par l'application Web.
9. Créez une fiche Google Workspace Marketplace pour le projet public. Ajoutez vos comptes d'utilisateurs test en tant que testeurs brouillons du SDK Marketplace testeurs. Enregistrez vos modifications en tant que brouillon.
10. Mettez à jour le projet public avec le code de votre module complémentaire.
11. En tant que testeur brouillon, installez le module complémentaire en accédant à l'URL de sa fiche Marketplace .
12. Envoyez une demande de validation OAuth pour votre projet public. Vous devrez enregistrer une courte vidéo montrant l'utilisation des habilitations des modules complémentaires à l'aide de l'un des comptes de testeur brouillon.
13. Publiez le module complémentaire public pour examen par Marketplace review.
14. Une fois approuvé, remplacez l'état de la fiche du SDK Marketplace par Listée.

Intégrations requises

Les éléments suivants sont requis pour créer un module complémentaire Classroom.

1. Authentification unique Google

   • Google Identity Platform. Google propose différentes options d'authentification.
   • Études de cas d'intégration.

   Pour savoir comment implémenter la connexion en suivant les bonnes pratiques, consultez la page Connexion sans friction.

2. Envoi à Google Workspace Marketplace en tant que module complémentaire Classroom

3. Implémentations d'iframe

   • Découverte des pièces jointes
   • Vue de l'enseignant
   • Vue de l'élève
   • Examen des travaux des élèves. L'iframe "Examen des travaux des élèves" n'est requis que si la pièce jointe fournit une pièce jointe de type activité.

Google Workspace Marketplace

Le Google Workspace Marketplace présente des applications d'entreprise qui peuvent être ajoutées à un domaine entier ou à des comptes Google Workspace individuels. Marketplace est intégré à la console d'administration Google. Les administrateurs de domaine peuvent ainsi trouver, installer et autoriser rapidement des applications pour des utilisateurs ciblés.

Voici quelques concepts clés à connaître :

• OAuthOAuth.
• Documentation destinée aux développeurs Google Workspace Marketplace.
• La section Éducation de Google Workspace Marketplace.