Déployer un module complémentaire Meet

Les modules complémentaires Google Meet sont créés et configurés dans le cadre d'un projet Google Cloud.

Créer un projet Google Cloud

Pour générer un projet Google Cloud, consultez Créer un projet Google Cloud.

Activer le SDK Google Workspace Marketplace et l'API des modules complémentaires Google Workspace

Le SDK Google Workspace Marketplace et l'API des modules complémentaires Google Workspace sont nécessaires pour développer des modules complémentaires Meet. Pour les activer, procédez comme suit :

  1. Ouvrez la console Google Cloud.
  2. En haut, si un autre projet est déjà ouvert, sélectionnez le nom du projet de votre application pour changer de projet.
  3. En haut, dans la barre de recherche, saisissez Google Workspace Marketplace SDK, puis appuyez sur Entrée.
  4. Ouvrez la page Google Workspace Marketplace SDK, puis cliquez sur Activer.

  5. Répétez ces étapes pour rechercher et activer Google Workspace add-ons API.

Créer un déploiement

Pour utiliser un module complémentaire dans Meet, vous avez besoin d'un déploiement et d'un fichier manifeste de module complémentaire.

  1. Ouvrez la console Google Cloud.
  2. En haut, si un autre projet est déjà ouvert, sélectionnez le nom du projet de votre application pour changer de projet.
  3. Cliquez sur API et services.
  4. Sélectionnez Google Workspace Marketplace SDK pour afficher la page d'informations.

Créer votre déploiement

Vous pouvez créer votre déploiement directement dans la console Google Cloud en créant un déploiement HTTP (recommandé) ou en utilisant Google Apps Script.

Déploiement HTTP

  1. Cliquez sur l'onglet Déploiements HTTP.
  2. Cliquez sur Créer un déploiement, puis saisissez l'ID de déploiement du module complémentaire.

    L'ID de déploiement est une chaîne arbitraire qui aide le développeur du module complémentaire à identifier le déploiement contenant le fichier manifeste du module complémentaire. Les ID de déploiement sont obligatoires et peuvent comporter jusqu'à 100 caractères.

  3. Cliquez sur Suivant.

    Un panneau latéral s'ouvre pour vous permettre d'envoyer la spécification du fichier manifeste du module complémentaire au format JSON. Il s'agit également de DEPLOYMENT.JSON.

    Le fichier manifeste du module complémentaire est la configuration centrale d'un module complémentaire Google Meet. L'exemple de code suivant montre les champs Meet disponibles pour le Web dans le fichier manifeste du module complémentaire.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    Remplacez les éléments suivants :

    • NAME: chaîne. Nom de votre module complémentaire Google Meet.
    • LOGO_URL: chaîne. URL du logo du module complémentaire Google Workspace. Il est utilisé pour le module complémentaire dans les produits Google Workspace.
    • SIDE_PANEL_URI: chaîne. URL du point d'entrée de votre application de module complémentaire. Elle s'affiche dans un iFrame dans le panneau latéral. L'origine de cette URL doit faire partie des origines spécifiées dans le champ ADD_ON_ORIGINS.
    • ADD_ON_ORIGINS: liste de chaînes. Liste des origines où votre module complémentaire est hébergé. Deux URL ont la même origine lorsqu'elles partagent le même schéma, l'hôte et le port. Les origines secondaires sont également autorisées, tout comme les sous-domaines génériques. Pour en savoir plus, consultez la section Sécurité des modules complémentaires.
    • DARK_MODE_LOGO_URL: chaîne. URL spécifique au mode sombre du logo du module complémentaire. Fournir un logo pour le mode sombre garantit que votre module complémentaire s'affichera de manière optimale dans n'importe quel thème Meet. Pour connaître les consignes de conception de logo, consultez la section Bonnes pratiques.
    • MEET_WEB_LOGO_URL : facultatif. Chaîne. URL spécifique à Meet du logo du module complémentaire. Ce logo est utilisé dans Meet. Si elle n'est pas présente, l'logoUrl de la section commune est utilisée. Pour connaître les consignes de conception de logo, consultez les bonnes pratiques.
    • SUPPORTS_SCREENSHARING : facultatif. Valeur booléenne. Si cette valeur est définie sur "false", les utilisateurs doivent utiliser le module complémentaire pour voir ce qui se passe dans une session collaborative de module complémentaire. Si cette valeur est définie sur "true", l'initiateur de la session de module complémentaire collaboratif peut partager son écran pour afficher le module complémentaire.
  4. Cliquez sur Envoyer.

    Pour en savoir plus sur les déploiements, consultez Créer une ressource de déploiement.

  5. Dans l'onglet Configuration de l'application, sous Intégration de l'application, sélectionnez Module complémentaire Google Workspace. Sélectionnez Déployer à l'aide d'une ressource de déploiement cloud, puis choisissez le déploiement HTTP approprié.

Google Apps Script

  1. Cliquez sur l'onglet Configuration de l'application.

  2. Sous Intégration d'applications, sélectionnez Module complémentaire Google Workspace. Sélectionnez Déployer à l'aide de l'ID de déploiement Google Apps Script, puis saisissez l'ID de déploiement de votre script.

  3. Cliquez sur Enregistrer.

    Pour savoir comment créer un projet Apps Script, consultez la documentation Apps Script. Le module complémentaire Meet repose uniquement sur le fichier manifeste appsscript.json, également appelé fichier manifeste du projet Apps Script. Assurez-vous que le fichier manifeste de votre projet Apps Script contient une section addOns et une section meet. Les sections addOns et meet suivent la même structure que celle décrite dans l'onglet "Déploiement HTTP".

    Contrairement aux autres modules complémentaires Google Workspace, les modules complémentaires Meet ne peuvent pas être entièrement créés dans Apps Script. Vous devez plutôt créer une application Web complète en créant un panneau latéral et une scène principale. L'URL du panneau latéral de votre application Web doit ensuite être spécifiée sous SIDE_PANEL_URI du fichier manifeste appsscript.json.

Installer et tester le module complémentaire dans Meet

Pour tester votre module complémentaire dans Meet, vous devez d'abord l'installer pour l'utilisateur connecté:

Déploiement HTTP

  1. Accédez au SDK Google Workspace Marketplace de votre projet dans la console Google Cloud.
  2. Cliquez sur l'onglet Déploiements HTTP.
  3. Cliquez sur Installer dans la colonne Actions.

Google Apps Script

  1. Suivez la documentation des modules complémentaires Google Workspace pour installer un module complémentaire non publié.

Vous devriez maintenant pouvoir utiliser votre module complémentaire dans une réunion. Pour l'essayer, démarrez une réunion sur meet.google.com. Le module complémentaire installé est désormais visible dans le panneau "Activités".

En plus d'installer votre module complémentaire pour l'utilisateur connecté, vous pouvez également le publier. Lorsque vous publiez votre module complémentaire Google Workspace, vous le rendez disponible pour que d'autres utilisateurs puissent le trouver, l'installer et l'utiliser.