Collaboration avec d'autres développeurs

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Apps Script fournit des fonctionnalités qui vous aident, vous et d'autres développeurs, à créer et à gérer ensemble des scripts, des modules complémentaires et des applications Web.

Collaboration : principes de base

Pour collaborer sur un projet, vous et vos collaborateurs devez disposer d'un accès éditeur au fichier de projet Apps Script (et à son conteneur, s'il s'agit d'un script lié). Cela permet à tous les membres de votre équipe de voir et de 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 en tant qu'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, la révision, la gestion des versions et (le cas échéant) le déploiement et la publication de votre projet, de votre module complémentaire ou de votre application Web. Les projets autonomes sont généralement les outils les plus simples de collaboration, 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 se produit 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.

Collaboration 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 sur l'interface de ligne de commande avec clasp.

Collaborer avec des Drive partagés

Les Drive partagés (anciennement "Drive d'équipe") offrent un espace partagé dans Google Drive où les groupes d'utilisateurs de Drive peuvent collaborer plus efficacement. Les fichiers placés dans un Drive partagé appartiennent à l'ensemble du groupe, et non à des individus. Cela signifie que lorsqu'un collaborateur quitte le groupe, il n'acquiert pas la propriété et le contrôle de son fichier.

Les Drive partagés vous permettent également de déplacer des fichiers entre les domaines. Un Drive partagé dans un domaine peut avoir 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 domaines différents.

Lorsque vous utilisez des Drive partagés pour collaborer sur des projets Apps Script, tenez compte des points suivants:

  1. Les collaborateurs disposant d'un accès éditeur à un Drive partagé peuvent créer ou déplacer des fichiers dans celui-ci. En tant qu'éditeurs de script, ils peuvent afficher et modifier les projets de script, exécuter du code, créer des versions de script et publier des modules complémentaires.
  2. Pour déployer des scripts en tant qu'applications Web ou exécutables pour 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.
  3. Les Drive partagés vous permettent de partager avec des personnes externes au groupe des fichiers spécifiques dans le Drive partagé, et de mettre à jour leurs autorisations de modification et d'affichage pour 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 dispose d'un accès en modification à un Drive partagé, vous ne pouvez pas le modifier pour qu'il dispose d'un accès en lecture seule à un fichier spécifique du Drive partagé.
  4. Les collaborateurs ayant un accès complet à un Drive partagé, en plus de ce qui précède, peuvent supprimer des fichiers et des projets Apps Script, et déplacer des fichiers hors du Drive partagé.
  5. Tous les scripts liés au 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 disposez d'un accès en modification à une feuille de calcul Google Sheets, vous pouvez également modifier tout code de projet Apps Script qui lui est associé. Le fait de placer un tel fichier de conteneur dans un Drive partagé accorde aux collaborateurs du Drive partagé le même accès au code de script qu'au conteneur.
  6. Lorsqu'un projet de script se trouve dans un Drive partagé, l'accès à son projet Cloud Platform (GCP) peut être restreint. Consultez la section Guide des projets GCP et des Drive partagés pour en savoir plus.
  7. Les applications Web déployées dans un domaine cessent de fonctionner si leur propriété est transférée vers un Drive partagé ou un compte appartenant à un autre domaine. Pour résoudre ce problème, rétablissez le script sur son domaine d'origine.
  8. De même, les projets de script déployés en tant qu'exécutable 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 vers un autre. Pour résoudre ce problème, rétablissez le script sur son domaine d'origine.

Collaborer grâce au partage de projets

Vous pouvez également collaborer sur un projet en le partageant directement avec tous les collaborateurs. Vous pouvez partager directement des projets de script qui se trouvent dans des dossiers Google Drive standards ou dans des Drive partagés. Si vous utilisez cette méthode, il est recommandé de planifier soigneusement le propriétaire et la maintenance du script au fil du temps.

Les projets indépendants s'affichent dans Google Drive sous forme de fichier que vous pouvez partager comme n'importe quel autre fichier. Pour en savoir plus, consultez la page Partager des fichiers et des dossiers.

Les projets liés à des conteneurs ne sont pas visibles dans Google Drive. Pour partager un projet lié à un conteneur, il vous suffit de partager le fichier parent du conteneur. Par exemple, si vous avez un script lié à une feuille de calcul Google Sheets, vous pouvez désigner une personne comme éditeur du script en lui faisant un éditeur de la feuille Google Sheets. Tous les projets de ce conteneur héritent des paramètres d'accès du lecteur et de l'éditeur.

Collaboration et projets de ressources

Les ressources sont des entités associées à votre projet, mais indépendantes de son code. Cette section explique comment la collaboration sur un projet affecte ses ressources, en particulier son projet Cloud Platform, ses déclencheurs, ses bibliothèques et ses propriétés utilisateur.

Collaboration et projets Cloud Platform

Chaque projet Apps Script est associé à un projet Cloud Platform (GCP). Les projets GCP possèdent leur propre ensemble de propriétaires, d'éditeurs et d'autres rôles, qui peut être différent de l'ensemble d'utilisateurs pouvant accéder au projet de script.

Si votre projet de script est destiné à être publié en tant que module complémentaire, il doit utiliser un projet GCP standard. Lorsque vous collaborez sur une application qui utilise un projet GCP standard, nous vous recommandons de configurer les propriétaires et les rôles GCP pour vous assurer que tous vos collaborateurs disposent des niveaux d'accès appropriés. Vous éviterez ainsi de perdre l'accès aux paramètres Cloud du projet, car ses propriétaires ne font plus partie de votre organisation. C'est particulièrement important pour les modules complémentaires.

Collaboration et déclencheurs

Lorsque vous collaborez sur un projet, les déclencheurs installables que vous créez ne sont pas partagés avec les personnes qui ont accès à votre projet. Si vous avez besoin d'une configuration de déclencheur cohérente pour tous les collaborateurs, vous pouvez utiliser le service Script pour créer des déclencheurs de manière automatisée, au moment de l'exécution. Pour en savoir plus, consultez la page Gérer les déclencheurs de manière automatisée.

Collaboration et bibliothèques

Les bibliothèques incluses dans votre projet sont disponibles pour les collaborateurs du projet. 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. En d'autres termes, les collaborateurs du projet ne peuvent pas afficher vos propriétés utilisateur ni y accéder, et vous ne pouvez pas afficher les leurs. Utilisez les propriétés de script si vous souhaitez partager les propriétés spécifiques d'un projet avec les collaborateurs. Pour en savoir plus, consultez le guide des propriétés.