Le déploiement d'un projet Google Apps Script est une version du script qui peut être utilisée comme application Web, module complémentaire Google Workspace ou exécutable d'API. En créant et en gérant des déploiements, vous pouvez itérer sur votre code, suivre vos modifications et contrôler la version du code à laquelle les utilisateurs ont accès.
Il existe deux types de déploiements :
- Les déploiements de tête, qui se synchronisent toujours avec le code du projet en cours.
- Les déploiements versionnés, qui se connectent à une version spécifique du projet.
Déploiements Head
Un déploiement "head" correspond au code du projet actuel. Lorsque vous créez un projet Apps Script, le système crée automatiquement un déploiement principal pour ce projet.
Le déploiement de tête se synchronise toujours avec le code enregistré le plus récemment. Par exemple, si vous créez un déploiement versionné, puis que vous modifiez votre code, le déploiement principal reflète ces modifications, tandis que le déploiement versionné reste intact.
Utilisez les déploiements head pour tester le code. N'utilisez pas les déploiements principaux pour un usage public.
Il n'existe qu'un seul déploiement de tête pour chaque projet Apps Script. Pour utiliser un déploiement de tête, vous devez au moins disposer d'un accès en lecture au projet de script.
Déploiements avec version
Un déploiement versionné met à disposition une version spécifique du code du projet. Cela permet aux utilisateurs de continuer à utiliser une version fonctionnelle pendant que vous apportez des modifications et des améliorations au code.
Lorsque vous publiez une application pour un usage public, utilisez toujours un déploiement versionné. Vous pouvez avoir plusieurs déploiements versionnés actifs à la fois.
Important : Vous ne pouvez pas transférer la propriété des déploiements versionnés. Si vous transférez la propriété d'un projet de script, le propriétaire des déploiements versionnés existants ne change pas. Si un administrateur supprime le compte du propriétaire du déploiement, des erreurs de script peuvent se produire dans ses déploiements.
Créer un déploiement versionné
Pour déployer une version d'un module complémentaire, d'un module complémentaire de l'éditeur, d'une application Chat ou d'un exécutable d'API, vous devez d'abord modifier l'association du projet Google Cloud de votre script Apps Script en remplaçant le projet par défaut par un projet standard.
Pour créer un déploiement versionné :
- Ouvrez le projet Apps Script.
- En haut à droite, cliquez sur Déployer > Nouveau déploiement.
- En regard de Sélectionner le 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 sur votre déploiement, puis cliquez sur Déployer.
Chaque nouveau déploiement peut être partagé en tant que bibliothèque. Si vous partagez le script en tant que bibliothèque, la description du déploiement est visible par les utilisateurs de la bibliothèque.
Afficher les déploiements versionnés
Pour afficher les déploiements d'un projet Apps Script, cliquez sur Déployer > Gérer les déploiements en haut de la page.
Pour afficher le code d'une version spécifique, consultez Afficher une version précédente.
Modifier un déploiement versionné
Vous pouvez modifier un déploiement versionné pour changer sa description ou sa version. Pour modifier un déploiement :
- Ouvrez le projet Apps Script.
- Cliquez sur Déployer > Gérer les déploiements.
- Sélectionnez le déploiement actif, puis cliquez sur Modifier .
- Apportez les modifications souhaitées, puis cliquez sur Déployer.
Pour modifier un déploiement archivé, redéployez-le, puis suivez les étapes précédentes.
Pour déployer une modification du code du projet, créez une version et modifiez le déploiement pour l'utiliser. Le déploiement utilise automatiquement la nouvelle version pour tous les utilisateurs.
Trouver un ID de déploiement
Chaque déploiement est associé à un ID de chaîne. Pour trouver cet ID :
- 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 méthode de test d'un déploiement dépend du type d'application que vous créez.
Module complémentaire Google Workspace
Pour tester un déploiement de module complémentaire, consultez Tester les modules complémentaires.
Module complémentaire Editor
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 Tester le déploiement d'une application Web.
Application Google Chat
Pour tester le déploiement d'une application Chat, créez un déploiement versionné du script afin d'accéder à son ID de déploiement.
Une fois que vous avez l'ID de déploiement, spécifiez-le dans la configuration de l'API Chat et suivez les étapes pour tester les fonctionnalités interactives.
Exécutable d'API
Pour tester un déploiement exécutable d'API, créez un déploiement versionné. Une fois le déploiement créé, 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
> Exécutable de l'API. - Copiez l'URL et utilisez-la pour tester le déploiement de votre fichier exécutable d'API.
Archiver un déploiement avec version
Vous ne pouvez pas supprimer les déploiements versionnés de votre liste de déploiements. À la place, vous pouvez les archiver.
Pour archiver un déploiement avec version :
- Ouvrez le projet Apps Script.
- Cliquez sur Déployer > Gérer les déploiements.
- Sélectionnez le déploiement, puis cliquez sur Archiver le déploiement .
Supprimer une version de l'historique du projet
Vous ne pouvez pas supprimer les déploiements versionnés, mais vous pouvez supprimer les versions de script qu'ils utilisent de l'historique de votre projet. Pour supprimer une version, elle ne doit pas être utilisée par un déploiement actif.
Pour supprimer une version, consultez Supprimer des versions.
Redéployer un déploiement archivé
- Ouvrez le projet Apps Script.
- En haut à droite, cliquez sur Déployer > Gérer les déploiements.
- Sous Archivée, sélectionnez le déploiement, puis cliquez sur Modifier > Déployer.