Un déploiement de projet Apps Script est une version du script qui peut ê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:
- Les déploiements principaux, qui sont toujours synchronisés avec le code du projet actuel.
- Les déploiements avec des versions gérées, qui sont connectés à une version de projet spécifique
Déploiements principaux
Un déploiement "head" 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 "head" est toujours synchronisé avec le dernier code enregistré. Par exemple, si vous créez un déploiement avec gestion des versions, puis modifiez votre code, le déploiement principal reflète ces modifications, tandis que le déploiement avec gestion des versions reste intact.
Utilisez les déploiements "head" pour tester le code. N'utilisez pas les déploiements "head" pour un usage public.
Déploiements avec des versions gérées
Un déploiement avec versions gérées rend disponible une version spécifique du code du projet. Cela permet à vos utilisateurs de continuer à utiliser une version fonctionnelle pendant que vous modifiez et améliorez le code.
Lorsque votre application est publiée pour une utilisation publique, utilisez toujours un déploiement avec versions gérées. Vous pouvez avoir plusieurs déploiements actifs en même temps avec gestion des versions.
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 gestion des versions existants dans le projet ne change pas. Si un administrateur supprime le compte du propriétaire du déploiement, vous risquez de rencontrer des erreurs de script 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, d'un module complémentaire Éditeur, d'une application Google Chat ou d'un exécutable d'API, vous devez d'abord changer l'association de projet Google Cloud dans Apps Script pour remplacer le projet par défaut par un 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.
- À côté de Select type (Sélectionner le type), cliquez sur "Enable deployment types" (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 gestion des versions
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, reportez-vous à la section Afficher une version précédente.
Modifier un déploiement avec gestion des versions
Vous pouvez modifier un déploiement avec gestion des versions pour changer sa description ou sa version. 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 dans le 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 utilisent ce déploiement.
Trouver un ID de déploiement
Chaque déploiement est associé à un identifiant de chaîne créé automatiquement. 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 trouver son ID.
Les ID de déploiement n'apparaissent 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 le déploiement d'un module complémentaire Google Workspace, consultez 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 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 les étapes pour activer l'API Google Chat. Sur la page "Configuration", sous "Autorisations", spécifiez uniquement votre adresse e-mail afin de 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 l'URL et utilisez-la pour tester votre déploiement de l'API exécutable.
Archiver un déploiement avec gestion des versions
Vous ne pouvez pas supprimer les déploiements avec des versions gérées. En revanche, vous pouvez les archiver.
Pour archiver un déploiement avec versions gérées:
- 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.