Apps Script udostępnia funkcje, które pomagają Tobie i innym deweloperom wspólnie tworzyć i utrzymywać skrypty, dodatki i aplikacje internetowe.
Podstawy współpracy
Aby współpracować nad projektem, Ty i Twoi współpracownicy musicie mieć uprawnienia do edycji pliku projektu Apps Script (i jego kontenera, jeśli jest to powiązany skrypt). Dzięki temu wszyscy członkowie zespołu mogą wyświetlać kod Apps Script i wprowadzać w nim zmiany. Mogą też tworzyć nowe wersje kodu, publikować dodatki i wdrażać skrypty jako aplikacje internetowe lub pliki wykonywalne dla interfejsu Apps Script API.
Możesz pomóc swojemu zespołowi, planując z wyprzedzeniem edycję, sprawdzanie, wersjonowanie i (w stosownych przypadkach) wdrażanie oraz publikowanie projektu, dodatku lub aplikacji internetowej. Samodzielne projekty są zwykle najłatwiejsze do współpracy, ponieważ pojawiają się bezpośrednio na Dysku Google i są zalecanym typem projektu do tworzenia dodatków i aplikacji internetowych.
Typowym problemem w współpracy jest sytuacja, gdy właściciel projektu skryptu opuszcza zespół bez przeniesienia własności projektu na inną osobę z zespołu. To może sprawić, że nie będziesz w stanie zarządzać projektem ani go aktualizować. Umieszczenie projektu skryptu na dysku współdzielonym zapobiega temu problemowi, ponieważ pliki na dysku współdzielonym nie mają konkretnych właścicieli.
Współpraca za pomocą narzędzia wiersza poleceń clasp
clasp umożliwia synchronizowanie projektów między witryną script.google.com a lokalnym systemem plików. Pozwala to usprawnić i zautomatyzować tworzenie kodu, jeśli Ty i Twoi współpracownicy używacie oprogramowania do zarządzania kontrolą wersji, takiego jak git.
Więcej informacji znajdziesz w przewodniku po interfejsie wiersza poleceń clasp.
Współpraca na dyskach współdzielonych
Dyski współdzielone (dawniej „Dyski zespołu”) to wspólna przestrzeń na Dysku Google, w której grupy użytkowników Dysku mogą skuteczniej współpracować. Pliki umieszczone na dysku współdzielonym są własnością całej grupy, a nie poszczególnych osób. Oznacza to, że gdy współpracownik opuści grupę, nie przejmie praw własności do plików ani kontroli nad nimi.
Dyski współdzielone umożliwiają też przenoszenie plików między domenami – dysk współdzielony w jednej domenie może mieć współpracowników z innej domeny, którzy mogą przenosić pliki z tej domeny na dysk współdzielony. Może to być bardzo przydatne dla deweloperów Apps Script, ponieważ zapewnia zespołowi możliwość tworzenia dodatków, aplikacji internetowych lub innego kodu dla klientów w różnych domenach.
Gdy używasz dysków współdzielonych do współpracy nad projektami Apps Script, pamiętaj o tym:
- Współpracownicy z uprawnieniami do edycji na dysku współdzielonym mogą tworzyć nowe pliki na tym dysku lub przenosić na niego pliki. Jako edytujący skrypty mogą wyświetlać i edytować projekty skryptów, uruchamiać kod skryptu, tworzyć nowe wersje skryptu oraz publikować dodatki.
- Aby w przypadku Apps Script API można było wdrażać skrypty jako aplikacje internetowe lub pliki wykonywalne, konto tworzące wdrożenie musi należeć do tej samej domeny co dysk współdzielony, na którym znajduje się skrypt.
- Dyski współdzielone umożliwiają udostępnianie określonych plików na dysku współdzielonym innym osobom spoza grupy oraz aktualizowanie uprawnień do ich edytowania i wyświetlania tak jak w przypadku innych plików na Dysku. Jeśli jednak użytkownik należy do zespołu, do którego należy dysk współdzielony, nie możesz ograniczyć jego dostępu do określonych plików. Jeśli na przykład użytkownik ma uprawnienia do edycji na dysku współdzielonym, nie możesz zmienić tych uprawnień na uprawnienia tylko do wyświetlania w przypadku konkretnego pliku na tym dysku.
- Współpracownicy z pełnym dostępem do dysku współdzielonego mogą też usuwać pliki i projekty Apps Script oraz przenosić pliki z dysku współdzielonego.
- Wszystkie skrypty powiązane z kontenerami korzystają z tych samych list uprawnień do wyświetlania i edytora, które są zdefiniowane dla pliku kontenera. Jeśli na przykład masz uprawnienia do edycji arkusza Google, masz też uprawnienia do edycji kodu dowolnego projektu Apps Script dołączonego do tego arkusza. Umieszczenie takiego pliku kontenera na dysku współdzielonym powoduje przyznanie współpracownikom z tego dysku takiego samego dostępu do kodu skryptu, jaki mają do samego kontenera.
- Jeśli projekt skryptu znajduje się na dysku współdzielonym, dostęp do projektu Cloud Platform (GCP) może być ograniczony. Więcej informacji znajdziesz w sekcji przewodnika o projektach i dyskach współdzielonych GCP.
- Aplikacje internetowe wdrożone w jednej domenie przestają działać, jeśli ich własność zmieni się na dysk współdzielony lub konto w innej domenie. Aby to naprawić, przenieś skrypt z powrotem do pierwotnej domeny.
- Podobnie projekty skryptów wdrożone jako plik wykonywalny interfejsu Apps Script API przestają działać, gdy zostaną wywołane przez interfejs API po przeniesieniu z jednej domeny do drugiej za pomocą dysku współdzielonego. Można to naprawić, przenosząc skrypt z powrotem do pierwotnej domeny.
Współpraca z folderem udostępnionym
Jeśli nie możesz współpracować z dyskiem współdzielonym, możesz użyć folderu współdzielonego. Gdy utworzysz lub przeniesiesz projekt Apps Script do folderu Dysku Google, do którego mają dostęp inne osoby, odziedziczą one te same uprawnienia do projektu Apps Script, które mają do tego folderu. Na przykład:
- Jeśli ktoś ma uprawnienia do edycji folderu, może edytować lub usunąć projekt Apps Script i uruchomić skrypt.
- Jeśli ktoś ma tylko dostęp do wyświetlania folderu, może wyświetlić projekt Apps Script i uruchomić skrypt.
Współpraca przy udostępnianiu projektów
Możesz współpracować nad projektem, udostępniając go bezpośrednio wszystkim współpracownikom. Możesz bezpośrednio udostępniać projekty skryptów znajdujące się w zwykłych folderach na Dysku Google lub na dyskach współdzielonych. Jeśli korzystasz z tej metody, zalecamy dokładne planowanie, kto będzie właścicielem skryptu i który będzie nim zarządzał.
Projekty samodzielne są widoczne na Dysku Google jako pliki i można je udostępniać jak zwykłe pliki. Więcej informacji znajdziesz w artykule Udostępnianie plików i folderów.
Projekty związane z kontenerem nie są widoczne na Dysku Google. Aby udostępnić projekt powiązany z kontenerem, udostępnij nadrzędny plik kontenera. Jeśli na przykład masz skrypt powiązany z arkuszem kalkulacyjnym Arkuszy Google, możesz wyznaczyć kogoś jako edytującego skrypt, przyznając mu rolę edytującego arkusz kalkulacyjny. Projekty powiązane z kontenerem dziedziczą ustawienia dostępu dla przeglądających i edytujących z pliku kontenera.
Wszystkie skrypty powiązane z kontenerem korzystają z tej samej listy dostępu właściciela, widza i edytującego zdefiniowanej dla pliku kontenera. Właściciel kontenera staje się właścicielem nowego projektu skryptu niezależnie od tego, kto go utworzył.
Zasoby do współpracy i projektów
Zasoby to elementy powiązane z Twoim projektem, które istnieją niezależnie od jego kodu. Z tej sekcji dowiesz się, jak współpraca nad projektem wpływa na jego zasoby, w szczególności na projekt Cloud Platform, jego uruchamiacze, biblioteki i właściwości użytkownika.
Współpraca i projekty Google Cloud
Każdy projekt Apps Script ma powiązany projekt Google Cloud. Projekty Google Cloud mają własnych właścicieli, edytorów i inne role, które mogą się różnić od zestawu użytkowników mających dostęp do projektu skryptu.
Jeśli projekt skryptu ma zostać opublikowany jako dodatek, musi korzystać ze standardowego projektu Google Cloud. Gdy współpracujesz nad aplikacją, która wykorzystuje standardowy projekt Google Cloud, zalecamy skonfigurowanie właścicieli i ról Google Cloud, aby wszyscy współpracownicy mieli odpowiedni poziom dostępu. Pomaga to uniknąć sytuacji, w której tracisz dostęp do ustawień projektu w chmurze, ponieważ jego właściciele nie są już w Twojej organizacji. Jest to szczególnie ważne w przypadku dodatków.
Współpraca i aktywatory
Podczas wspólnej pracy nad projektem żadne utworzone przez Ciebie aktywatory możliwe do zainstalowania nie są udostępniane osobom, które mają dostęp do Twojego projektu. Jeśli chcesz mieć spójne ustawienia reguł dla wszystkich współpracowników, możesz użyć usługi skryptu, aby tworzyć reguły programowo w czasie wykonywania. Więcej informacji znajdziesz w artykule Zarządzanie regułami za pomocą kodu.
Współpraca i biblioteki
Biblioteki użyte w projekcie są dostępne dla współpracowników. Jeśli jednak nie mają co najmniej dostępu na poziomie odczytu do załączonej biblioteki, nie mogą z nich korzystać – w takim przypadku skrypt zwraca błąd. Więcej informacji o bibliotekach znajdziesz w artykule Zarządzanie bibliotekami.
Współpraca i właściwości użytkownika
Właściwości użytkownika są unikalne dla użytkownika, który je utworzył. Oznacza to, że użytkownicy współpracujący przy projekcie nie mogą zobaczyć ani uzyskać dostępu do Twoich usług użytkownika, a Ty nie możesz zobaczyć ani uzyskać dostępu do ich usług. Jeśli chcesz udostępnić współpracownikom właściwości projektu, użyj właściwości skryptu. Więcej informacji znajdziesz w przewodniku Pojęcia.