Mettre à jour vos modules complémentaires publiés

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Si vous avez déjà créé et publié un module complémentaire pour étendre Gmail ou Agenda, vous pouvez le convertir en Google Workspace module complémentaire. Les instructions de cette page expliquent comment ajouter Google Workspace des fonctionnalités à vos modules complémentaires Gmail ou Agenda existants, puis de publier votre module complémentaire mis à niveau pour qu'il puisse être découvert et installé.

Vous pouvez transférer la nouvelle fonctionnalité vers votre module complémentaire d'origine pour conserver Google Workspace votre fiche Marketplace, vos installations et vos utilisateurs. Cette mise à niveau vous permet également de bénéficier de nouvelles Google Workspace fonctionnalités complémentaires, telles que les pages d'accueil.

Étape 1: Créez une copie du projet Apps Script de votre module complémentaire

Votre module complémentaire mis à niveau utilise le même projet Google Cloud que votre module complémentaire publié, mais il est important de créer et d'utiliser une copie du projet Apps Script sous-jacent afin que les utilisateurs existants ne soient pas affectés pendant que vous testez la version mise à niveau. Si vous mettez à niveau une copie du projet de script d'origine, vous pourrez toujours accéder au code d'origine et le redéployer ultérieurement si nécessaire.

Nouvel éditeur

  1. Ouvrez votre projet complémentaire complémentaire Gmail ou votre module complémentaire de visioconférence Agenda.
  2. À gauche, cliquez sur Vue d'ensemble .
  3. À droite, cliquez sur Créer une copie .
  4. Sur la gauche, cliquez sur Paramètres du projet > Changer de projet.
  5. Cliquez sur GCP Project Number (Numéro de projet GCP).
  6. Saisissez le même numéro de projet que celui associé à votre projet Apps Script existant déjà publié.
  7. Cliquez sur Définir le projet.

Ancien éditeur

  1. Ouvrez votre projet complémentaire complémentaire Gmail ou votre module complémentaire de visioconférence Agenda.
  2. En haut, cliquez sur Fichier &gt ; Créer une copie.
  3. En haut du projet Apps Script copié, cliquez sur Resources (Ressources) > Cloud Platform project (Projet Cloud Platform).
  4. Saisissez le même numéro de projet que celui associé à votre projet Apps Script existant déjà publié.
  5. Cliquez sur Définir le projet > Fermer.

Étape 2: Intégrez les Google Workspace fonctionnalités complémentaires

Vous devez concevoir et implémenter toutes les Google Workspace fonctionnalités complémentaires que vous souhaitez ajouter à votre module.

  1. Déterminez le contenu à afficher dans les fiches de la page d'accueil du module complémentaire, et indiquez s'il doit apparaître dans Gmail, Agenda, Drive ou dans une combinaison des trois. Si vous souhaitez configurer une page d'accueil pour plusieurs hôtes, déterminez s'il peut s'agir de la même page d'accueil ou si vous voulez des fiches de page d'accueil personnalisées pour chaque hôte.
  2. Dans le projet Apps Script que vous avez copié, créez vos fiches de page d'accueil à l'aide des fonctions homepageTrigger. Veillez à inclure toutes les fonctions ou logiques compatibles pour contrôler vos nouvelles interfaces de page d'accueil.
  3. Pensez à ajouter des fiches contextuelles déclenchées par une action d'un utilisateur, comme l'ouverture d'un fil de discussion Gmail ou d'un événement d'agenda.

  4. Mettez à jour tout accès aux objets d'événement dans votre module complémentaire (dans les fonctions de rappel du widget ou dans les fonctions de déclenchement du contexte) afin d'utiliser la nouvelle structure d'objet d'événement. La nouvelle structure contient toujours les mêmes champs d'objet d'événement utilisés par les modules complémentaires Gmail et Agenda, mais ces champs d'origine sont obsolètes et seront à terme supprimés.

Étape 3: Mettez à jour le fichier manifeste de votre module complémentaire

La façon dont les informations de configuration sont stockées dans la structure de fichier manifeste desGoogle Workspace modules complémentaires a été considérablement différente de celle utilisée pour les modules complémentaires de visioconférence et d'agenda. Lorsque vous mettez à niveau votre module complémentaire, vous devez mettre à jour les champs manifestes de votre projet Apps Script conformément aux tableaux ci-dessous. Vous devez mettre à jour toutes les sous-propriétés pertinentes vers la nouvelle propriété addOns.

Veillez également à mettre à jour le champ oauthScopes de votre fichier manifeste si nécessaire pour refléter les autorisations requises par votre module complémentaire mis à jour.

Pour en savoir plus sur les Google Workspace fichiers manifestes complémentaires, consultez la section Manifestes.

Modules complémentaires Gmail

Champ du fichier manifeste d'origine Action requise
gmail.composeTrigger Déplacer vers addOns.gmail.composeTrigger.
gmail.contextualTriggers[] Déplacez la liste vers addOns.gmail.contextualTriggers[].
gmail.logoUrl Déplacer vers addOns.common.logoUrl.
gmail.name Déplacer vers addOns.common.name.
gmail.openLinkUrlPrefixes[] Déplacez la liste vers addOns.common.openLinkUrlPrefixes[].
gmail.primaryColor Déplacer vers addOns.common.layoutProperties.primaryColor.
gmail.secondaryColor Déplacer vers addOns.common.layoutProperties.secondaryColor.
gmail.universalActions[] Déplacez la liste vers addOns.common.universalActions[].
gmail.universalActions[].text Déplacez chaque champ gmail.universalActions[].text vers un champ addOns.common.universalActions[].label correspondant.
gmail.useLocalFromApp Déplacer vers addOns.common.useLocaleFromApp.

Modules complémentaires de visioconférence Agenda

Champ du fichier manifeste d'origine Action requise
calendar.createSettingsUrlFunction Déplacer vers addOns.calendar.createSettingsUrlFunction.
calendar.conferenceSolution[] Déplacer vers addOns.calendar.conferenceSolution[].
calendar.logoUrl Déplacer vers addOns.common.logoUrl.
calendar.name Déplacer vers addOns.common.name.

Étape 4: Testez votre module complémentaire mis à niveau

Pour tester votre module complémentaire mis à niveau avant de le publier, consultez la page Tester les Google Workspace modules complémentaires.

Étape 5: Demandez un examen de votre module complémentaire

Tous les Google Workspace modules complémentaires, qu'il s'agisse d'un module complémentaire mis à niveau ou de zéro, doivent être approuvés pour pouvoir figurer sur la Google Workspace place de marché.

Pour envoyer votre module complémentaire pour examen:

  1. Assurez-vous que votre module complémentaire répond à toutes les exigences de publication des modules complémentaires.

  2. Créez un déploiement avec versions gérées pour votre Google Workspace module complémentaire (dans le nouveau projet Apps Script) à l'aide de la version du code que vous souhaitez publier. N'essayez pas de publier le modèle à l'aide d'un déploiement "head".

  3. Si vous avez ajouté des niveaux d'accès lors de la mise à niveau de votre module complémentaire, vous devez demander une validation OAuth. Par exemple, si votre module complémentaire Gmail utilise de nouveaux champs d'application Drive ou Agenda dans la versionGoogle Workspace , vous devez les envoyer pour validation. La validation prend souvent quelques jours. Par conséquent, commencez le processus le plus tôt possible. Assurez-vous que votre module complémentaire a été validé avant de passer à l'étape 6.

Étape 6: Proposez votre module complémentaire mis à niveau

  1. Ouvrez le Google Workspace SDK Marketplace.

  2. Sur la gauche, cliquez sur Configuration. Ce panneau contient un formulaire dans lequel vous fournissez des informations sur votre module complémentaire.

  3. Mettez à jour la description courte, la description détaillée et les captures d'écran de votre fiche pour refléter les nouvelles fonctionnalités du Google Workspace module complémentaire.

  4. Sous Extensions, cliquez sur le bouton Mettre à niveau versGoogle Workspace module complémentaire. Dans la zone de texte qui s'affiche, saisissez le nouvel ID de déploiement que vous avez créé pour votre Google Workspace module complémentaire à l'étape précédente. Si votre ID de déploiement est valide, la liste des hôtes compatibles s'affiche.

  5. Si vous avez ajouté des niveaux d'accès à votre module complémentaire Google Workspace , veillez à les ajouter à la section Habilitations OAuth 2.0 de la page Configuration. Les niveaux d'accès indiqués dans cette section doivent correspondre exactement à ceux indiqués dans le fichier manifeste du module complémentaire.

  6. Vérifiez que les informations saisies dans le formulaire sont correctes. Cliquez ensuite sur Enregistrer les modifications.

Si vous avez des questions ou que vous rencontrez un problème lors de la mise à niveau Google Workspace des modules complémentaires, contactez-nous.

Questions fréquentes

Vous trouverez ci-dessous les questions fréquentes concernant les mises à niveau des modules complémentaires:

Puis-je mettre à niveau mon module complémentaire Editor ?

La plupart des modules complémentaires de l'éditeur peuvent être déplacés vers Google Workspace Modules complémentaires. Toutefois, ils ne peuvent pas être mis à niveau vers des Google Workspace modules complémentaires aussi facilement que des modules complémentaires Gmail et Agenda.

Si vous souhaitez migrer votre module complémentaire Editor vers un module Google Workspace , vous devez réécrire l'interface utilisateur du module complémentaire HTML à l'aide d'une interface basée sur une carte et mettre à jour votre traitement JavaScript vers le service de carte.

Il est possible que certains services de votre module complémentaire Editor existant ne soient pas disponibles dans Card Service. Par exemple, si votre module complémentaire d'éditeur inclut un sélecteur de fichier, il n'existe pas d'équivalent équivalent dans le service de cartes pour les Google Workspace modules complémentaires.

Puis-je créer un module complémentaire Google Workspace différent et conserver mes modules complémentaires existants ?

Vous pouvez créer des modules complémentaires supplémentaires Google Workspace sous différents noms de marque, mais nous n'autorisons pas les modules complémentaires de visioconférence Gmail ou Agenda distincts sous le même nom de marque que votre module complémentaire Google Workspace . Si vous avez des questions ou si vous souhaitez demander une dérogation, contactez-nous.

Mes utilisateurs devront-ils de nouveau autoriser le module complémentaire après la mise à niveau ?

Tant que votre Google Workspace module complémentaire utilise le même projet Cloud Platform (GCP) sous-jacent, avec un ID client OAuth associé, vos utilisateurs n'auront pas besoin de réautoriser les autorisations qu'ils ont précédemment autorisées pour votre module complémentaire d'origine. Toutefois, si vous ajoutez des champs d'application pendant le processus de mise à niveau, vos utilisateurs doivent les autoriser la première fois qu'ils utilisent la version Google Workspacede votre module complémentaire.

Puis-je mettre à niveau mon extension Chrome vers un Google Workspace module complémentaire et transférer des utilisateurs ?

Non. Vous ne pouvez pas transférer des utilisateurs, des installations et des avis sur une extension Chrome. Vous devez créer un Google Workspace module complémentaire et rediriger les utilisateurs de votre extension Chrome vers Google Workspace Marketplace.

Puis-je regrouper plusieurs modules complémentaires Google Workspace avec mon module complémentaire ?

Consultez Répertorier les intégrations d'applications.