Un déploiement de projet Apps Script est une version du script mise à disposition en tant qu'application Web, module complémentaire ou exécutable d'API. Créer et gérer des déploiements vous permet d'itérer votre code, d'effectuer le suivi de vos modifications et de contrôler la version exacte du code à laquelle vos utilisateurs ont accès.
Il existe deux types de déploiements:
- Les déploiements principaux, qui sont toujours synchronisés avec le code du projet actuel.
- Les déploiements avec versions gérées, qui sont connectés à une version de projet spécifique
Déploiement principal
Un déploiement principal correspond au code du projet actuel. Lorsque vous créez un projet Apps Script, vous créez automatiquement un déploiement principal pour ce projet.
Le déploiement principal est toujours synchronisé avec le dernier code enregistré. Par exemple, si vous créez un déploiement avec versions gérées, puis modifiez votre code, le déploiement principal reflète ces modifications, tandis que le déploiement avec versions gérées reste intact.
Utilisez des déploiements Head pour tester le code. N'utilisez pas les déploiements Head pour un usage public.
Déploiements avec gestion des versions
Un déploiement avec versions gérées met à disposition une version spécifique du code du projet. Cela permet à vos utilisateurs de continuer à utiliser une version fonctionnelle pendant que vous apportez des modifications et des améliorations au code.
Lorsque votre application est publiée pour une utilisation publique, utilisez toujours un déploiement avec versions gérées. Vous pouvez disposer de plusieurs déploiements avec gestion des versions actifs en même temps.
Important: Vous ne pouvez pas transférer la propriété des déploiements avec versions gérées. Si vous transférez la propriété d'un projet de script à quelqu'un, le propriétaire des déploiements avec versions gérées dans le projet ne change pas. Si un administrateur supprime le compte du propriétaire du déploiement, des erreurs de script peuvent se produire pour ses déploiements.
Créer un déploiement avec versions gérées
Pour déployer une version d'un module complémentaire Google Workspace ou d'un module complémentaire d'éditeur, d'une application Google Chat ou d'un exécutable d'API, vous devez d'abord basculer le projet Google Cloud associé au projet par défaut de votre script Apps Script en projet standard.
Pour créer un déploiement avec versions gérées, procédez comme suit:
- Ouvrez le projet Apps Script.
- En haut à droite, cliquez sur Déployer > Nouveau déploiement.
- En regard de Sélectionner un type, cliquez sur "Activer les types de déploiement" .
- Sélectionnez le type de déploiement que vous souhaitez déployer. Pour les modules complémentaires Google Workspace, les modules complémentaires des éditeurs et les applications Google Chat, sélectionnez Module complémentaire.
Saisissez les informations concernant votre déploiement, puis cliquez sur Déployer.
Afficher les déploiements avec versions gérées
Pour afficher les déploiements d'un projet Apps Script, en haut, cliquez sur Déployer > Gérer les déploiements.
Pour afficher le code d'une version spécifique, consultez la section Afficher une version précédente.
Modifier un déploiement avec versions gérées
Vous pouvez modifier la description ou la version d'un déploiement avec des versions gérées. Pour modifier un déploiement, procédez comme suit:
- Ouvrez le projet Apps Script.
- Cliquez sur Déployer > Gérer les déploiements.
- Sélectionnez le déploiement actif que vous souhaitez modifier, puis cliquez sur Modifier .
Apportez les modifications souhaitées, puis cliquez sur Déployer.
Si vous souhaitez modifier un déploiement archivé, vous devez le redéployer, puis suivre les étapes précédentes.
Lorsque vous souhaitez déployer une modification du code du projet, créez une version et modifiez le déploiement pour l'utiliser. La nouvelle version est automatiquement utilisée par tous les utilisateurs qui se servent de ce déploiement.
Trouver un ID de déploiement
Chaque déploiement est associé à un ID de chaîne créé automatiquement. Pour le trouver, procédez comme suit:
- Ouvrez le projet Apps Script.
- En haut à droite, cliquez sur Déployer > Gérer les déploiements.
Sélectionnez un déploiement actif pour trouver son ID.
Les ID de déploiement ne s'affichent que pour les déploiements actifs.
Tester un déploiement
La façon dont vous testez un déploiement dépend du type d'application que vous créez.
Module complémentaire Google Workspace
Pour tester un déploiement de modules complémentaires Google Workspace, consultez Tester des modules complémentaires Google Workspace.
Module complémentaire de l'éditeur
Pour tester le déploiement d'un module complémentaire d'éditeur, consultez Tester un module complémentaire d'éditeur.
Application Web
Pour tester le déploiement d'une application Web, consultez la section Tester le déploiement d'une application Web.
Application Google Chat
Pour tester le déploiement d'une application Chat, vous devez d'abord créer un déploiement avec versions gérées du script pour accéder à son ID de déploiement.
Une fois que vous disposez de l'ID de déploiement, suivez la procédure permettant d'activer l'API Google Chat. Sur la page "Configuration", sous "Autorisations", spécifiez uniquement votre adresse e-mail pour pouvoir installer et tester votre application.
Exécutable d'API
Pour tester un déploiement exécutable d'API, vous devez d'abord créer un déploiement avec versions gérées. Après avoir créé un déploiement, procédez comme suit:
- En haut à droite du projet Apps Script, cliquez sur Déployer > Tester les déploiements.
- À côté de "Sélectionner le type", cliquez sur Activer les types de déploiement
> API Executable.
- Copiez et utilisez l'URL pour tester votre déploiement API Executable.
Archiver un déploiement avec versions gérées
Vous ne pouvez pas supprimer les déploiements avec versions gérées. En revanche, vous pouvez les archiver.
Pour archiver un déploiement avec versions gérées, procédez comme suit:
- Ouvrez le projet Apps Script.
- Cliquez sur Déployer > Gérer les déploiements.
- Sélectionnez le déploiement que vous souhaitez archiver, puis cliquez sur Archiver le déploiement .
Redéployer un déploiement archivé
- Ouvrez le projet Apps Script.
- En haut à droite, cliquez sur Déployer > Gérer les déploiements.
- Sur la gauche, sous Archivé, sélectionnez le déploiement que vous souhaitez redéployer, puis cliquez sur Modifier > Déployer.