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 pliku projektu Apps Script z uprawnieniami do edycji (i do jego kontenera, jeśli jest to skrypt powiązany). Dzięki temu każdy członek zespołu może wyświetlać kod Apps Script i wprowadzać w nim zmiany. Edytujący 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 zespołowi, planując z wyprzedzeniem sposób edytowania, sprawdzania, wersjonowania oraz (w stosownych przypadkach) wdrażania i publikowania 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 w pracy zespołowej jest sytuacja, w której właściciel projektu skryptu opuszcza zespół bez przekazania własności projektu innemu członkowi zespołu. Może to uniemożliwić Ci utrzymanie lub zaktualizowanie 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. 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 (wcześniej znane jako „Dyski zespołu”) to udostępnione miejsce na Dysku Google, w którym grupy użytkowników Dysku mogą efektywniej współpracować. Pliki umieszczone na dysku współdzielonym należą do całej grupy, a nie do poszczególnych osób. Oznacza to, że gdy współpracownik opuści grupę, nie zabierze ze sobą prawa 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ż umożliwia zespołowi tworzenie dodatków, aplikacji internetowych lub innego kodu dla klientów w różnych domenach.
Jeśli używasz dysków współdzielonych do współpracy nad projektami Apps Script, pamiętaj o tych kwestiach:
- Współpracownicy, którzy mają uprawnienia edytującego na dysku współdzielonym, mogą tworzyć nowe pliki na tym dysku lub przenosić na niego istniejące. Jako edytorzy skryptów mogą wyświetlać i edytować projekty skryptów, uruchamiać kod skryptu, tworzyć nowe wersje skryptów i publikować dodatki.
- Aby wdrożyć skrypty jako aplikacje internetowe lub pliki wykonywalne dla Apps Script API, konto, na którym tworzone jest wdrożenie, musi należeć do tej samej domeny co dysk wspólny, 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 edytowania 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 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 dla przeglądających i edytujących zdefiniowanych 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 Cloud Platform (GCP) może być ograniczony. Szczegółowe informacje znajdziesz w sekcji przewodnika Projekty GCP i dyski współdzielone.
- Aplikacje internetowe wdrożone w jednej domenie przestają działać, jeśli ich własność zostanie przeniesiona na dysk wspólny lub konto w innej domenie. Można to naprawić, przenosząc 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. Można to naprawić, przenosząc skrypt z powrotem do jego pierwotnej domeny.
Współpraca w folderze udostępnionym
Jeśli nie możesz współpracować na dysku współdzielonym, możesz zamiast tego 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, uzyskają one taki 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 dostęp do folderu tylko w trybie wyświetlania, może wyświetlać projekt Apps Script i uruchamiać skrypt.
Współpraca dzięki udostępnianiu projektów
Możesz współpracować nad projektem, udostępniając go bezpośrednio wszystkim współpracownikom. Projekty skryptów znajdujące się w zwykłych folderach Dysku Google lub na dyskach współdzielonych możesz udostępniać bezpośrednio. Jeśli używasz tej metody, zalecamy dokładne zaplanowanie, kto będzie właścicielem skryptu i kto będzie go utrzymywać.
Samodzielne projekty są widoczne na Dysku Google jako pliki, które możesz udostępniać tak 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 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 przyznać komuś uprawnienia do edytowania skryptu, przyznając mu uprawnienia do edytowania arkusza kalkulacyjnego. Projekty powiązane z kontenerem dziedziczą ustawienia dostępu do wyświetlania i edytowania 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. W tej sekcji wyjaśniamy, jak współpraca nad projektem wpływa na jego zasoby, w szczególności na projekt Cloud Platform, 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óry może się różnić od zestawu użytkowników, którzy mają dostęp do projektu skryptu.
Jeśli projekt skryptu ma być opublikowany jako dodatek, musi korzystać ze 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 wszyscy współpracownicy mieli odpowiedni poziom dostępu. Pomaga to zapobiegać sytuacjom, w których tracisz dostęp do ustawień projektu w chmurze, ponieważ jego właściciele nie są już częścią Twojej organizacji. Jest to szczególnie ważne w przypadku dodatków.
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ę reguł dla wszystkich współpracowników, możesz użyć usługi skryptów, aby tworzyć reguły programowo w czasie działania. Więcej informacji znajdziesz w artykule Programowe zarządzanie wyzwalaczami.
Współpraca i biblioteki
Biblioteki uwzględnione w projekcie są dostępne dla współpracowników. Jeśli jednak nie mają co najmniej dostępu do odczytu do dołączonej biblioteki, 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ępnić współpracownikom właściwości specyficzne dla projektu. Więcej informacji znajdziesz w przewodniku po usługach.