Apps Script fournit des fonctionnalités qui vous aident, vous et d'autres développeurs, à créer et gérer des scripts, des modules complémentaires et des applications Web ensemble.
Bases de la collaboration
Pour collaborer sur un projet, vous et vos collaborateurs devez tous disposer d'un accès éditeur au fichier de projet Apps Script (et à son conteneur, s'il s'agit d'un script lié). Tous les membres de votre équipe peuvent ainsi voir et modifier le code Apps Script. Les éditeurs peuvent également créer des versions de code, publier des modules complémentaires et déployer des scripts en tant qu'applications Web ou exécutables pour l'API Apps Script.
Vous pouvez aider votre équipe en planifiant à l'avance la manière dont vous gérez la modification, l'examen, la gestion des versions et (le cas échéant) le déploiement et la publication de votre projet, module complémentaire ou application Web. Les projets autonomes sont généralement les plus faciles à collaborer, car ils apparaissent directement dans Google Drive et constituent le type de projet recommandé pour le développement de modules complémentaires et d'applications Web.
Un problème courant de collaboration survient lorsqu'un propriétaire de projet de script quitte l'équipe sans transférer la propriété du projet à un autre membre de l'équipe. Cela peut vous empêcher de gérer ou de mettre à jour le projet. Placer votre projet de script dans un Drive partagé permet d'éviter ce problème, car les fichiers d'un Drive partagé n'ont pas de propriétaires spécifiques.
Collaborer avec l'outil de ligne de commande clasp
clasp vous permet de synchroniser des projets entre script.google.com et votre système de fichiers local. Cela vous permet de simplifier et d'automatiser le développement de votre code si vous et vos collaborateurs utilisez un logiciel de gestion du contrôle des sources tel que git.
Pour en savoir plus, consultez le guide Interface de ligne de commande à l'aide de clasp.
Collaborer à l'aide de Drive partagés
Les Drive partagés (anciennement "Drive d'équipe") fournissent un espace partagé dans Google Drive, où les groupes d'utilisateurs Drive peuvent collaborer plus efficacement. Les fichiers placés dans un Drive partagé appartiennent au groupe dans son ensemble, et non à des individus. Cela signifie que lorsqu'un collaborateur quitte le groupe, il n'en assume ni la propriété, ni le contrôle.
Les Drive partagés vous permettent également de déplacer des fichiers entre différents domaines. Un Drive partagé d'un domaine peut être associé à des collaborateurs d'un autre domaine qui peuvent déplacer des fichiers de ce domaine vers le Drive partagé. Cela peut être très utile aux développeurs Apps Script, car cela permet à une équipe de développer des modules complémentaires, des applications Web ou d'autres codes pour des clients de différents domaines.
Lorsque vous utilisez des Drive partagés pour collaborer sur des projets Apps Script, gardez à l'esprit les points suivants:
- Les collaborateurs disposant d'un accès éditeur à un Drive partagé peuvent y créer ou y déplacer des fichiers. En tant qu'éditeurs de scripts, ils peuvent afficher et modifier les projets de scripts, exécuter le code des scripts, créer des versions de script et publier des modules complémentaires.
- Pour déployer des scripts en tant qu'applications Web ou exécutables de l'API Apps Script, le compte qui crée le déploiement doit appartenir au même domaine que le Drive partagé dans lequel se trouve le script.
- Les Drive partagés vous permettent de partager des fichiers spécifiques avec des personnes extérieures au groupe, et de mettre à jour leurs autorisations de modification et d'affichage sur ces fichiers comme pour tout autre fichier Drive. Toutefois, si un utilisateur fait partie de l'équipe à laquelle appartient le Drive partagé, vous ne pouvez pas réduire son accès à des fichiers spécifiques. Par exemple, si un utilisateur est autorisé à modifier un Drive partagé, vous ne pouvez pas le remplacer par un accès en lecture seule à un fichier spécifique du Drive partagé.
- Les collaborateurs disposant d'un accès complet à un Drive partagé peuvent également supprimer des fichiers et des projets Apps Script, et déplacer des fichiers hors du Drive partagé.
- Tous les scripts liés à un conteneur utilisent les mêmes listes d'accès en lecture et en éditeur que celles définies pour le fichier de conteneur. Par exemple, si vous êtes autorisé à modifier une feuille de calcul Google Sheets, vous disposez également de droits de modification sur le code de projet Apps Script qui lui est associé. Lorsque vous placez un tel fichier de conteneur dans un Drive partagé, les collaborateurs du Drive partagé bénéficient du même accès au code du script que pour le conteneur lui-même.
- Lorsqu'un projet de script réside dans un Drive partagé, l'accès à son projet Cloud Platform (GCP) peut être limité. Pour en savoir plus, consultez la section du guide Projets GCP et Drive partagés.
- Les applications Web déployées dans un domaine cessent de fonctionner si leur propriété passe à un Drive partagé ou à un compte d'un autre domaine. Vous pouvez corriger ce problème en déplaçant le script vers son domaine d'origine.
- De même, les projets de script déployés en tant qu'exécutables d'API Apps Script cessent de fonctionner lorsqu'ils sont appelés par l'API s'ils sont déplacés via un Drive partagé d'un domaine à un autre. Pour résoudre ce problème, replacez le script dans son domaine d'origine.
Collaborer à l'aide d'un dossier partagé
Si vous ne pouvez pas collaborer avec un Drive partagé, utilisez un dossier partagé. Lorsque vous créez ou déplacez un projet Apps Script dans un dossier Google Drive auquel d'autres personnes ont accès, celles-ci héritent des mêmes droits d'accès au projet Apps Script que ceux dont elles disposent pour le dossier. Exemple :
- Si un utilisateur est autorisé à modifier le dossier, il peut modifier ou supprimer le projet Apps Script, puis exécuter le script.
- Si une personne n'a qu'un accès en lecture au dossier, elle peut afficher le projet Apps Script et exécuter le script.
Collaborez grâce au partage de projets
Vous pouvez collaborer sur un projet en le partageant directement avec tous les collaborateurs. Vous pouvez partager directement des projets de script qui résident dans des dossiers Google Drive standards ou des Drive partagés. Si vous utilisez cette méthode, nous vous recommandons de planifier soigneusement la propriété et la gestion du script au fil du temps.
Les projets autonomes s'affichent dans Google Drive sous forme de fichiers. Vous pouvez les partager comme n'importe quel autre fichier. Pour en savoir plus, consultez la section Partager des fichiers et des dossiers.
Les projets liés à des conteneurs ne sont pas visibles depuis Google Drive. Pour partager un projet lié à un conteneur, partagez le fichier du conteneur parent. Par exemple, si un script est lié à une feuille de calcul Google Sheets, vous pouvez le désigner comme éditeur du script. Les projets liés à un conteneur héritent des paramètres d'accès lecteur et éditeur de leur fichier de conteneur.
Tous les scripts liés au conteneur utilisent la même liste d'accès propriétaire, lecteur et éditeur que celle définie pour le fichier de conteneur. Le propriétaire du conteneur devient propriétaire du nouveau projet de script, quel que soit son créateur.
Ressources de collaboration et de projet
Les ressources sont des entités associées à votre projet, mais qui existent indépendamment de son code. Cette section explique l'impact de la collaboration sur un projet sur ses ressources, en particulier: le projet Cloud Platform, les déclencheurs, les bibliothèques et les propriétés utilisateur.
Collaboration et projets Google Cloud
Chaque projet Apps Script est associé à un projet Google Cloud. Les projets Google Cloud ont leur propre ensemble de propriétaires, d'éditeurs et d'autres rôles, qui peut être différent de l'ensemble d'utilisateurs ayant accès au projet de script.
Si votre projet de script est destiné à être publié en tant que module complémentaire, il doit utiliser un projet Google Cloud standard. Lorsque vous collaborez sur une application qui utilise un projet Google Cloud standard, nous vous recommandons de configurer les propriétaires et les rôles Google Cloud pour vous assurer que tous vos collaborateurs disposent des niveaux d'accès appropriés. Cela permet d'éviter les situations dans lesquelles vous perdez l'accès aux paramètres Cloud du projet, car ses propriétaires ne font plus partie de votre organisation. Cela est particulièrement important pour les modules complémentaires.
Collaboration et déclencheurs
Lorsque vous collaborez sur un projet, les déclencheurs pouvant être installés que vous créez ne sont pas partagés avec les utilisateurs ayant accès à votre projet. Si vous devez disposer d'une configuration de déclencheur cohérente pour tous les collaborateurs, vous pouvez utiliser le service Script pour créer des déclencheurs par programmation au moment de l'exécution. Pour en savoir plus, consultez la page Gérer les déclencheurs par programmation.
Collaboration et bibliothèques
Les bibliothèques incluses dans votre projet sont accessibles à vos collaborateurs. Toutefois, s'ils ne disposent pas au moins d'un accès en lecture à une bibliothèque incluse, ils ne peuvent pas les utiliser. Dans ce cas, le script génère une erreur. Pour en savoir plus sur les bibliothèques, consultez la page Gérer les bibliothèques.
Collaboration et propriétés utilisateur
Les propriétés utilisateur sont propres à l'utilisateur qui les a créées. Cela signifie que les collaborateurs du projet ne peuvent pas voir vos propriétés utilisateur ni y accéder, et que vous ne pouvez pas voir les leurs. Utilisez les propriétés de script si vous souhaitez partager des propriétés spécifiques à un projet avec les collaborateurs. Pour en savoir plus, consultez le guide des propriétés.