Apps Script udostępnia funkcje, które pomagają Tobie i innym programistom wspólnie tworzyć i obsługiwać skrypty, dodatki oraz aplikacje internetowe.
Podstawowe informacje o 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 Twojego zespołu będą mogli przeglądać kod Apps Script i wprowadzać w nim zmiany. Edytorzy mogą też tworzyć nowe wersje kodu, publikować dodatki i wdrażać skrypty jako aplikacje internetowe lub pliki wykonywalne Apps Script API.
Możesz pomóc swojemu zespołowi, planując z wyprzedzeniem sposób edytowania, sprawdzania, obsługi wersji i (w stosownych przypadkach) wdrażania i publikowania projektu, dodatku lub aplikacji internetowej. Wspólna praca nad samodzielnymi projektami zazwyczaj najłatwiejszym, ponieważ pojawiają się bezpośrednio na Dysku Google i są zalecanym typem projektów przy tworzeniu dodatków i aplikacji internetowych.
Częstym problemem podczas współpracy jest sytuacja, w której właściciel projektu skryptu opuszcza zespół bez przeniesienia własności projektu na inną osobę. 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 tym dysku 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 uprościć i automatyzować programowanie kodu, jeśli Ty i Twoi współpracownicy korzystacie z 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 (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 przejmuje własności pliku ani kontroli nad nim.
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 programistów Apps Script, ponieważ umożliwia zespołowi tworzenie dodatków, aplikacji internetowych i innego kodu dla klientów w różnych domenach.
Gdy korzystasz z dysków współdzielonych do współpracy nad projektami Apps Script, pamiętaj o tych kwestiach:
- Współpracownicy z uprawnieniami do edycji dysku współdzielonego mogą tworzyć i przenosić nowe pliki na dysk współdzielony. Jako edytorzy skryptów mogą wyświetlać i edytować projekty skryptów, uruchamiać kod skryptu, tworzyć nowe wersje skryptów i 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 osobom spoza grupy i 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ć mu 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 określonego 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 dowolnego kodu projektu Apps Script dołączonego do tego pliku. 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 przestaną działać, jeśli ich własność zmieni się na dysk współdzielony lub konto w innej domenie. Można to poprawić, przenosząc skrypt z powrotem do pierwotnej domeny.
- Podobnie projekty skryptów wdrożone jako plik wykonywalny Apps Script API przestają działać, gdy zostaną wywołane przez interfejs API, jeśli zostaną przeniesione z jednej domeny do drugiej za pomocą dysku współdzielonego. Można to poprawić, przenosząc skrypt z powrotem do pierwotnej domeny.
Współpraca z folderem udostępnionym
Jeśli nie możesz współpracować na dysku współdzielonym, możesz użyć folderu udostępnionego. Gdy utworzysz lub przeniesiesz projekt Apps Script do folderu na Dysku Google, do którego mają dostęp inne osoby, odziedziczą one taki sam poziom dostępu do projektu Apps Script, jaki 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 uprawnienia tylko do wyświetlania folderu, może wyświetlić projekt Apps Script i uruchomić skrypt.
Współpraca przy udostępnianiu projektów
Nad projektem możesz współpracować, 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ł.
Samodzielne projekty są wyświetlane na Dysku Google jako plik, który możesz udostępniać jak każdy inny plik. Więcej informacji znajdziesz w artykule Udostępnianie plików i folderów.
Projekty powiązane z kontenerami nie są widoczne na Twoim Dysku Google. Aby udostępnić projekt powiązany z kontenerem, udostępnij plik kontenera nadrzędnego. 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 uprawnień wyświetlającego i edytującego plik kontenera.
Wszystkie skrypty powiązane z kontenerem korzystają z tej samej listy uprawnień 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ł.
Zasoby do współpracy i projektów
Zasoby to encje powiązane z projektem, które istnieją niezależnie od jego kodu. W tej sekcji wyjaśniamy, jak współpraca nad projektem wpływa na jego zasoby, w szczególności na projekt Cloud Platform, aktywatory, biblioteki i właściwości użytkownika.
Współpraca i projekty Google Cloud
Z każdym projektem Apps Script jest powiązany projekt Google Cloud. Projekty Google Cloud mają własny zestaw właścicieli, edytujących i innych ról, które mogą się różnić od zbioru 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. Zapobiega to sytuacjom, w których utracisz dostęp do ustawień Cloud projektu, gdy jego właściciele nie będą już należeć do Twojej organizacji. Jest to szczególnie ważne w przypadku dodatków.
Współpraca i reguły
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, aby spójna konfiguracja aktywatorów była spójna dla wszystkich współpracowników, możesz użyć usługi skryptu do automatycznego tworzenia aktywatorów w czasie działania. Więcej informacji znajdziesz w artykule o automatycznym zarządzaniu aktywatorami.
Współpraca i biblioteki
Biblioteki uwzględnione w Twoim 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ą korzystać z tych bibliotek – 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 pracujący nad projektem nie widzą Twoich właściwości użytkownika ani nie mają do nich dostępu, a Ty nie możesz zobaczyć ich właściwości. Jeśli chcesz udostępnić współpracownikom właściwości związane z projektem, użyj właściwości skryptu. Więcej informacji znajdziesz w przewodniku po usługach.