Google Apps Script udostępnia funkcje, które pomagają zespołom wspólnie tworzyć i utrzymywać skrypty, dodatki do Google Workspace i aplikacje internetowe. Ten przewodnik dotyczy aktywnej współpracy nad projektem wielu programistów. Jeśli chcesz udostępnić kod innym osobom, aby mogły go uwzględnić w swoich projektach, zapoznaj się z przewodnikiem Biblioteki.
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 skrypt powiązany). Dzięki temu wszyscy członkowie zespołu będą mogli wyświetlać i zmieniać kod Apps Script. Edytujący mogą też tworzyć nowe wersje kodu, publikować dodatki i wdrażać skrypty jako aplikacje internetowe lub pliki wykonywalne interfejsu Apps Script API.
Z wyprzedzeniem zaplanuj edytowanie, sprawdzanie, obsługa wersji oraz (w stosownych przypadkach) wdrażanie i publikowanie projektu, dodatku lub aplikacji internetowej. Projekty samodzielne są zwykle najłatwiejsze we współpracy, ponieważ pojawiają się bezpośrednio na Dysku Google i są zalecanym typem projektu do tworzenia dodatków i aplikacji internetowych.
Częstym problemem we współpracy jest sytuacja, w której właściciel projektu skryptu opuszcza zespół bez przeniesienia własności projektu na innego członka 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.
Zawsze udostępniaj własność projektów skryptów. Jeśli ktoś opuści organizację i jego konto zostanie usunięte, utracisz dostęp do skryptów, które nie mają innych właścicieli. Udostępnij skrypt na Dysku lub przenieś go na dysk współdzielony.
Współpraca z narzędziem wiersza poleceń clasp
clasp umożliwia synchronizację projektów między script.google.com a lokalnym systemem plików. Umożliwia to usprawnienie i zautomatyzowanie tworzenia kodu, jeśli Ty i Twoi współpracownicy używacie oprogramowania do zarządzania kontrolą źródła, takiego jak git.
Więcej informacji znajdziesz w przewodniku po interfejsie wiersza poleceń.clasp
Współpraca na dyskach współdzielonych
Dyski współdzielone są dostępne tylko dla klientów Google Workspace Business i Google Workspace Enterprise.
Dyski współdzielone to wspólne miejsce na Dysku, w którym 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 osób. Oznacza to, że gdy współpracownik opuści grupę, nie zabierze ze sobą własności 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. Dzięki temu zespół może tworzyć dodatki, aplikacje internetowe lub inny kod dla klientów w różnych domenach.
Gdy używasz dysków współdzielonych do współpracy nad projektami Apps Script:
- Współpracownicy, którzy mają uprawnienia do edycji dysku współdzielonego, mogą tworzyć nowe pliki na dysku współdzielonym lub przenosić na niego pliki. Jako edytorzy skryptów mogą wyświetlać i edytować projekty skryptów, uruchamiać kod skryptu, tworzyć nowe wersje skryptu i publikować dodatki.
- Aby wdrożyć skrypty jako aplikacje internetowe lub pliki wykonywalne dla interfejsu Apps Script API, konto, na którym tworzone jest 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 ich uprawnień do edycji i wyświetlania tych plików, tak jak w przypadku każdego innego pliku 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 dysku współdzielonego, nie możesz zmienić tych uprawnień na dostęp w trybie 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 dla przeglądających i uprawnień do edycji, które są zdefiniowane dla pliku kontenera. Jeśli na przykład masz uprawnienia do edycji arkusza Google, masz też uprawnienia do edycji kodu projektu Apps Script do niego dołączonego. Umieszczenie takiego pliku kontenera na dysku współdzielonym przyznaje współpracownikom dysku współdzielonego taki sam dostęp do kodu skryptu, jaki mają do samego kontenera.
- Gdy projekt skryptu znajduje się na dysku współdzielonym, dostęp do jego projektu w chmurze Google może być ograniczony. Szczegółowe informacje znajdziesz w sekcji przewodnika Projekty Google Cloud i dyski współdzielone.
- Aplikacje internetowe wdrożone w jednej domenie przestają działać, jeśli ich własność zostanie przeniesiona 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ć po wywołaniu przez interfejs API, jeśli zostaną przeniesione z jednej domeny do drugiej za pomocą Dysku współdzielonego. Aby to naprawić, przenieś skrypt z powrotem do pierwotnej domeny.
Współpraca w folderze udostępnionym
Zachowaj ostrożność, jeśli tworzysz lub przenosisz projekt Apps Script do folderu udostępnionego. Upewnij się, że folder jest udostępniony tylko zaufanym osobom.
Jeśli nie możesz współpracować na dysku współdzielonym, użyj folderu udostępnionego. Gdy utworzysz projekt Apps Script lub przeniesiesz go do folderu na Dysku, do którego mają dostęp inne osoby, odziedziczą one ten sam dostęp do projektu Apps Script, jaki mają do folderu. Na przykład:
- Jeśli ktoś ma uprawnienia do edycji folderu, może edytować lub usuwać projekt Apps Script i uruchamiać skrypt.
- Jeśli ktoś ma tylko uprawnienia do wyświetlania folderu, może wyświetlać projekt Apps Script i uruchamiać skrypt.
Współpraca dzięki udostępnianiu projektów
Współpraca nad projektem przez bezpośrednie udostępnianie go wszystkim współpracownikom. bezpośrednio udostępniać projekty skryptów znajdujące się w zwykłych folderach na Dysku lub na dyskach współdzielonych; Starannie zaplanuj, kto będzie właścicielem skryptu i kto będzie go utrzymywać.
Samodzielne projekty są widoczne na Dysku jako pliki. Możesz je udostępniać tak samo jak inne pliki. Więcej informacji znajdziesz w artykule Udostępnianie plików i folderów.
Projekty powiązane z kontenerem nie są widoczne na Dysku. 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 przyznać komuś uprawnienia edytującego do skryptu, przyznając mu uprawnienia edytującego do arkusza kalkulacyjnego. Projekty powiązane z kontenerem dziedziczą ustawienia dostępu do wyświetlania i uprawnienia do edycji z pliku kontenera.
Wszystkie skrypty powiązane z kontenerem korzystają z tej samej listy dostępu właściciela, przeglądającego i edytującego zdefiniowanej dla pliku kontenera. Właściciel kontenera przejmuje własność nowego projektu skryptu niezależnie od tego, kto go utworzył.
Współpraca i zasoby projektu
Zasoby to elementy powiązane z projektem, ale istniejące 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 w chmurze Google, wyzwalacze, 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łasny zestaw właścicieli, edytujących i innych ról, które mogą różnić się od zestawu użytkowników, którzy mają dostęp do projektu skryptu.
Współpraca i aktywatory
Gdy współpracujesz nad projektem, żadne utworzone przez Ciebie wyzwalacze instalowane nie są udostępniane osobom, które mają dostęp do Twojego projektu. Jeśli chcesz mieć spójną konfigurację wyzwalaczy dla wszystkich współpracowników, użyj usługi skryptów, aby tworzyć wyzwalacze programowo w czasie działania. Więcej informacji znajdziesz w artykule Programowe zarządzanie wyzwalaczami.
współpracowników.
Współpraca i biblioteki
Biblioteki uwzględnione w projekcie są dostępne dla współpracowników. Jeśli jednak nie mają dostępu do uwzględnionej biblioteki na poziomie co najmniej odczytu, nie mogą z niej korzystać – w takim przypadku skrypt zgłasza 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 współpracownicy projektu nie mogą wyświetlać ani uzyskiwać dostępu do Twoich właściwości użytkownika, a Ty nie możesz wyświetlać ani uzyskiwać dostępu do ich właściwości. Użyj właściwości skryptu, jeśli chcesz udostępniać współpracownikom właściwości związane z projektem. Więcej informacji znajdziesz w przewodniku po właściwościach.