Apps Script fournit des fonctionnalités qui vous aident, vous et les autres développeurs, à créer et gérer les scripts, les modules complémentaires et les applications Web ensemble.
Principes de base de la collaboration
Pour collaborer sur un projet, vous et vos collaborateurs devez tous avoir un accès éditeur au fichier de projet Apps Script (et à son conteneur, s'il s'agit d'un script lié). Ainsi, tous les membres de votre équipe d'afficher et de modifier le code Apps Script. Les éditeurs peuvent aussi créer du code versions, 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 façon dont vous gérez le montage, le contrôle, la gestion des versions et, le cas échéant, le déploiement et la publication projet, module complémentaire ou application Web. Les projets autonomes sont généralement les plus faciles pour collaborer, car ils apparaissent directement dans Google Drive et constituent 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 le é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. Positionnez votre dans un Drive partagé empêche ce problème, car les fichiers d'un Drive partagé n'ont pas de propriétaire spécifique.
Collaborer avec l'outil de ligne de commande clasp
clasp vous permet de synchroniser des projets entre script.google.com et votre fichier local
du système d'exploitation. Cela vous permet de simplifier et d'automatiser le développement de votre code si vous
et vos collaborateurs utilisent des logiciels de gestion de code source
git
Pour en savoir plus, consultez la page Interface de ligne de commande
à l'aide du guide clasp.
Collaborer grâce aux Drive partagés
Les Drive partagés (anciennement appelés "Drive d'équipe") fournissent un espace partagé dans Google Drive où des groupes de Drive les utilisateurs puissent collaborer plus efficacement. Les fichiers placés dans un Drive partagé appartiennent à l'éditeur par le groupe dans son ensemble, plutôt que par des individus. Cela signifie que lorsqu'un un collaborateur quitte le groupe auquel il n'est ni propriétaire, ni contrôle. de l'IA générative.
Les Drive partagés vous permettent aussi de déplacer des fichiers d'un domaine à un autre, d'un domaine peuvent compter des collaborateurs d'un autre domaine autorisés à déplacer des fichiers ce domaine dans le Drive partagé. Cela peut s'avérer très utile pour Apps Script développeurs, car il permet à une équipe de développer des modules complémentaires, des applications Web, ou un autre code pour les clients de domaines différents.
Lorsque vous utilisez des Drive partagés pour collaborer sur des projets Apps Script, conservez le à l'esprit ce qui suit:
- Les collaborateurs disposant d'un accès éditeur à un Drive partagé peuvent créer ou déplacer de nouveaux fichiers dans le Drive partagé. En tant qu'éditeurs de script, ils peuvent afficher et modifier projets de scripts, exécuter le code de script, créer des versions de scripts, publier des modules complémentaires.
- Pour déployer des scripts en tant qu'applications Web ou exécutables pour l'API Apps Script, procédez comme suit : le compte qui crée le déploiement doit appartenir au même domaine que Drive partagé dans lequel se trouve le script.
- Les Drive partagés vous permettent de partager des fichiers spécifiques dans un Drive partagé pour : d'autres utilisateurs extérieurs au groupe, et de mettre à jour leurs autorisations de modification et d'affichage ces fichiers comme n'importe quel autre fichier Drive. Toutefois, si un utilisateur une partie du à laquelle appartient le Drive partagé, vous ne pouvez pas limiter son accès à des . Par exemple, si un utilisateur est autorisé à modifier un Drive partagé, vous ne pouvez pas pour qu'il bénéficie d'un accès en lecture seule à un fichier spécifique dans le Drive partagé.
- Les collaborateurs disposant d'un accès complet à un Drive partagé peuvent également supprimer des fichiers. et Apps Script, et déplacer des fichiers du Drive partagé.
- Tous les scripts liés au conteneur utiliser les mêmes listes d'accès "Lecteur" et "Éditeur" définies pour le fichier du conteneur. Par exemple, si vous êtes autorisé à modifier une feuille de calcul Google Sheets, l'accès en modification à tout code de projet Apps Script associé. Placer un tel dans un Drive partagé : accorde aux collaborateurs de ce Drive le même accès au code de script que pour le conteneur lui-même.
- Lorsqu'un projet de script se trouve dans un Drive partagé, l'accès à ses Projet Cloud Platform (GCP) peut être limité. Consultez le Projets GCP et Drive partagés pour en savoir plus.
- Applications Web déployées dans un domaine cessent de fonctionner si leur propriété change Drive partagé ou à un compte appartenant à un autre domaine. Vous pouvez résoudre ce problème en renvoyant le script vers son domaine d'origine.
- De même, créez des scripts pour les projets déployé en tant qu'exécutable de l'API Apps Script cessent de fonctionner lorsqu'elles sont appelées par l'API en cas de déplacement via un Drive partagé depuis d'un domaine à un autre. Pour résoudre ce problème, replacez le script dans son domaine d'origine.
Collaborer sur un dossier partagé
Si vous ne pouvez pas collaborer avec un Drive partagé, vous pouvez utiliser un dossier partagé, à la place. Lorsque vous créez ou déplacez un projet Apps Script vers un dossier Google Drive auquel d'autres personnes ont accès, elles héritent du même niveau d'accès au projet Apps Script dont ils disposent pour le dossier. Exemple :
- Si quelqu'un est autorisé à modifier le dossier, il peut modifier ou supprimer le Projet Apps Script et exécuter le script.
- Si une personne dispose uniquement d'un accès en lecture au dossier, elle peut consulter 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 toutes les collaborateurs. Vous pouvez partager directement les projets de script qui se trouvent dans des dossiers Google Drive ou dans des Drive partagés. Si vous utilisez cette méthode, nous vous recommandons de planifier soigneusement les personnes qui détiennent et gèrent le script au fil du temps.
Les projets autonomes s'affichent dans votre Google Drive sous forme de fichiers. Vous pouvez les partager comme n'importe quel autre fichier. Pour plus pour en savoir plus, consultez Partager des fichiers et des dossiers
Les projets liés à des conteneurs ne sont pas visibles depuis votre Google Drive. Pour partager un projet lié à un conteneur, partagez conteneur. Par exemple, si vous avez un script lié à une feuille de calcul Google Sheets feuille de calcul, vous désigner quelqu'un comme éditeur du script feuille de calcul. Les projets liés au conteneur héritent des droits d'accès en lecture et en éditeur de son fichier conteneur.
Tous les scripts liés au conteneur utilisent les mêmes propriétés d'accès "Éditeur" définie pour le fichier conteneur. Le propriétaire du conteneur propriétaire d'un nouveau projet de script, quel que soit son créateur.
Ressources sur la collaboration et les projets
Les ressources sont des entités associées à votre projet, mais qui existent indépendamment de son code. Cette section explique comment collaborer sur un projet affecte ses ressources, en particulier: son projet Cloud Platform, ses déclencheurs les bibliothèques et les propriétés utilisateur.
Projets collaboratifs et projets Google Cloud
Chaque projet Apps Script est associé à un objet Projet Google Cloud Les projets Google Cloud disposent de 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 script projet.
Si votre projet de script est destiné à être publié sous forme module complémentaire, elle doit utiliser projet Google Cloud standard. Lorsque vous collaborez sur une application qui utilise un projet Google Cloud standard, nous recommandent vous configurez 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 vous aide éviter les situations où vous perdrez 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, déclencheurs installables que vous créez ne sont pas partagées avec les personnes qui ont accès à votre projet. Si vous avez besoin d’avoir une configuration de déclencheur cohérente pour tous les collaborateurs, vous pouvez utiliser Le service de script pour créer des déclencheurs de manière automatisée, au moment de l'exécution. Pour en savoir plus, consultez Gérer les déclencheurs par programmation
Collaboration et bibliothèques
Les bibliothèques incluses dans votre projet sont à la disposition des 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 utiliser ces bibliothèques. Dans ce cas, le script génère une erreur. Pour en savoir plus sur les bibliothèques, consultez Gérer les bibliothèques.
Propriétés de collaboration et propriétés utilisateur
Propriétés utilisateur sont propres à l'utilisateur qui les a créés. Cela signifie que les collaborateurs du projet ne peuvent pas voir vos propriétés utilisateur ni y accéder, et vous ne peuvent pas voir ou accéder aux leurs. Utilisez Propriétés de script si vous souhaitez partager des propriétés spécifiques à un projet avec les collaborateurs. Pour Pour en savoir plus, consultez les Guide des propriétés