Un déploiement de projet Apps Script est une version du script qui est mise à disposition pour être utilisée en tant qu'application Web, module complémentaire 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 exacte du code à laquelle vos utilisateurs ont accès.
Il existe deux types de déploiements:
- Déploiements principaux, qui sont toujours synchronisés avec le code du projet en cours.
- Déploiements avec version, qui sont associés à une version de projet spécifique.
Déploiements de tête
Un déploiement "head" correspond au code de 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 code le plus récemment enregistré. Par exemple, si vous créez un déploiement avec version et que vous modifiez votre code, le déploiement principal reflète ces modifications, tandis que le déploiement avec version reste intact.
Utilisez des déploiements principaux pour tester le code. N'utilisez pas de déploiements principaux pour une utilisation publique.
Déploiements avec versions
Un déploiement avec version 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 version. Vous pouvez avoir plusieurs déploiements avec version active à 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 à un autre utilisateur, le propriétaire des déploiements versionnés existants du 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 version
Pour déployer une version d'un module complémentaire Google Workspace, d'un module complémentaire Editor, d'une application Google Chat ou d'un exécutable d'API, vous devez d'abord passer du projet par défaut au projet standard pour l'association de votre projet Google Cloud Apps Script.
Pour créer un déploiement avec version:
- Ouvrez le projet Apps Script.
- En haut à droite, cliquez sur Déployer > Nouveau déploiement.
- À côté 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.
Afficher les déploiements avec version
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 avec version
Vous pouvez modifier la description ou la version d'un déploiement versionné. 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 nouvelle version et modifiez le déploiement pour l'utiliser. La nouvelle version est automatiquement utilisée par tous les utilisateurs qui utilisent ce déploiement.
Trouver un ID de déploiement
Un ID de chaîne est automatiquement créé pour chaque déploiement. Pour trouver cet ID, 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 en trouver l'ID.
Les ID de déploiement n'apparaissent que pour les déploiements actifs.
Tester un déploiement
La manière dont vous testez un déploiement dépend du type d'application que vous créez.
Module complémentaire Google Workspace
Pour tester le déploiement d'un module complémentaire Google Workspace, consultez la section Testing Google Workspace add-ons (Tester les 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 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 version du script pour accéder à son ID de déploiement.
Une fois que vous avez obtenu l'ID de déploiement, spécifiez-le dans la configuration de l'API Chat et suivez la procédure pour tester les fonctionnalités interactives.
Exécutable d'API
Pour tester un déploiement exécutable d'API, vous devez d'abord créer un déploiement avec version. 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 "Activer les types de déploiement"
> Exécutable de l'API.
- Copiez et utilisez l'URL 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 avec version. Vous pouvez les archiver à la place.
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 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.
- À gauche, sous Archivé, sélectionnez le déploiement que vous souhaitez redéployer, puis cliquez sur Modifier > Déployer.