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ć dostęp do edytora pliku projektu Apps Script (oraz jego kontenera, jeśli jest to skrypt związany). 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ż są widoczne 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. Może to uniemożliwić Ci utrzymanie lub aktualizowanie projektu. Umieszczenie projektu skryptu na dysku współdzielonym zapobiega temu problemowi, ponieważ pliki na dysku współdzielonym nie mają konkretnych właścicieli.
Współpraca z narzędziem wiersza poleceń clasp
clasp umożliwia synchronizację projektów między 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 clasp dotyczącym interfejsu wiersza poleceń.
Współpraca na dyskach współdzielonych
Dyski współdzielone (dawniej „Dyski zespołu”) to udostępniona przestrzeń na Dysku Google, w której grupy użytkowników Dysku mogą efektywniej współpracować. Pliki umieszczone na dysku współdzielonym należą do grupy jako całości, a nie do poszczególnych użytkowników. 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 wdrażać skrypty jako aplikacje internetowe lub pliki wykonywalne interfejsu Apps Script API, konto, które tworzy 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 kontenerem korzystają z tych samych list dostępu widzów i edytujących zdefiniowanych 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, że współpracownicy dysku współdzielonego mają taki sam dostęp do kodu skryptu jak 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 dotyczącej projektów i dysków współdzielonych w Google Cloud Platform.
- 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 na inną za pomocą Dysku udostępnionego. 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 z udostępnianiem projektu
Możesz współpracować nad projektem, udostępniając go bezpośrednio wszystkim współpracownikom. Możesz bezpośrednio udostępniać projekty skryptów, które znajdują się w zwykłych folderach Dysku Google lub na dyskach współdzielonych. Jeśli używasz tej metody, dokładnie zaplanuj, kto będzie właścicielem skryptu i kto będzie go utrzymywać w długim okresie.
Projekty samodzielne są widoczne na Dysku Google jako pliki i można je udostępniać jak każdy inny plik. 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 związany z kontenerem, udostępnij nadrzędny plik kontenera. Jeśli na przykład masz skrypt powiązany z arkuszu Google, możesz nadać komuś uprawnienia edytującego do skryptu, przyznając mu uprawnienia edytujące do arkusza. 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 używają 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 być opublikowany jako dodatek, musi używać standardowego projektu Google Cloud. Jeśli współpracujesz nad aplikacją, która korzysta ze standardowego projektu Google Cloud, zalecamy skonfigurowanie właścicieli i ról Google Cloud, aby mieć pewność, że wszyscy współpracownicy mają odpowiednie poziomy 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
Gdy współpracujesz nad projektem, żadne instalowalne wyzwalacze, które utworzysz, 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 uwzględnione w Twoim projekcie są dostępne dla współpracowników projektu. 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żytkowników, 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.