Każdy projekt Apps Script korzysta z Google Cloud do zarządzania autoryzacją, usługami zaawansowanymi i innymi informacjami. Aby można było konfigurować te ustawienia i nimi zarządzać, każdy projekt Apps Script ma powiązany projekt Google Cloud. Projekt skryptu może korzystać z domyślnego projektu tworzonego automatycznie przez Apps Script lub standardowego projektu utworzonego przez Ciebie. Ogólnie rzecz biorąc, projekty domyślne nadają się do tworzenia zwykłych i prostych skryptów, ale zalecamy użycie standardowego projektu w przypadku każdej aplikacji, która ma skomplikowaną, komercyjną jakość lub ma być publikowana.
W każdej chwili możesz przełączyć projekt domyślny na projekt standardowy, ale nie możesz z powrotem przełączyć się na projekt domyślny. Najlepiej jest wybrać projekt Cloud, którego Twój skrypt używa na wczesnym etapie tworzenia. Późniejsze przełączenie może spowodować komplikacje, takie jak konieczność ponownej autoryzacji użytkowników.
Domyślne projekty Cloud
Gdy tworzysz projekt Apps Script, Apps Script tworzy domyślny projekt Cloud, który działa w tle.
- W przypadku większości skryptów nie musisz nigdy widzieć ani dostosowywać tego domyślnego projektu. Apps Script obsługuje niezbędne interakcje z Google Cloud. Jeśli na przykład aktywujesz usługę zaawansowaną w edytorze Apps Script, usługa Apps Script aktywuje tę usługę w domyślnym projekcie Cloud podczas zapisywania projektu skryptu.
- W przypadku niektórych skryptów musisz korzystać z konsoli Google Cloud. W takich przypadkach skrypt musi używać standardowego projektu Cloud. Aby na przykład wyświetlać logi Google Cloud w konsoli Google Cloud, skrypt musi używać standardowego projektu.
Domyślnie projekty Cloud mają zasadę zarządzania tożsamościami i dostępem z 1 wpisem. Jest to konto usługi Google, które jest właścicielem domyślnego projektu. Konto usługi Google to appsdev-apps-dev-script-auth@system.gserviceaccount.com
.
Wyświetl lub zaktualizuj domyślne projekty Cloud
Większość użytkowników nie może bezpośrednio lokalizować, wyświetlać ani edytować domyślnych projektów w konsoli Google Cloud. Jeśli jesteś administratorem, zapoznaj się z artykułem Wyświetlanie domyślnych projektów Google Cloud.
Jeśli projekt skryptu został utworzony przed 8 kwietnia 2019 r., możesz użyć projektu domyślnego, do którego masz dostęp w konsoli Google Cloud. Aby uzyskać dostęp do projektu domyślnego, przejdź do ustawień projektu skryptu i kliknij numer projektu.
Usuń domyślne projekty Cloud
Jeśli jesteś administratorem, możesz usuwać domyślne projekty Cloud, tak jak standardowe projekty Cloud. Zobacz Usuwanie projektów Google Apps Script.
Jeśli nie jesteś administratorem, nie możesz usuwać projektów domyślnych. Apps Script usuwa jednak projekty domyślne w tych sytuacjach:
- Jeśli usuniesz projekt skryptu lub przełączysz go na projekt standardowy, Apps Script usunie domyślny projekt dołączony do skryptu wraz ze wszystkimi ustawieniami i informacjami, które się w nim znajdują.
- Jeśli skrypt nie działa przez co najmniej 180 dni, Apps Script usuwa powiązany z nim projekt domyślny. Jeśli skrypt zostanie uruchomiony po usunięciu domyślnego projektu przez Apps Script, Apps Script utworzy projekt dla skryptu.
Standardowe projekty Cloud
Domyślne projekty Cloud to najlepsze rozwiązanie w przypadku większości projektów skryptów, chyba że musisz skonfigurować projekt ręcznie. W takich sytuacjach musisz zmienić projekt skryptu na użycie projektu standardowego.
W poniższych sekcjach opisano, kiedy Apps Script wymaga standardowego projektu, oraz poznasz właściwości takich projektów i typowe zadania, które w nich wykonuje. Poniższe zadania możesz wykonywać tylko w standardowych projektach.
Gdy Apps Script wymaga standardowych projektów Cloud
Projektu standardowego musisz użyć w tych sytuacjach:
- Aby opublikować projekt skryptu jako dodatek w Google Workspace Marketplace.
- Aby zweryfikować klienta OAuth projektu skryptu.
- Gdy masz aplikację, która musi wykonywać funkcje w projekcie skryptu za pomocą metody
scripts.run
interfejsu Apps Script API. - Aby wyświetlić logi Google Cloud projektu skryptu w konsoli Google Cloud. Konsola Google Cloud zapewnia więcej narzędzi do filtrowania i wyświetlania logów. Może być też bardziej przydatna niż uproszczony widok dostępny w panelu Apps Script.
- Aby wyświetlić raporty o błędach w projekcie skryptu za pomocą funkcji Error Reporting.
- Utwórz okno otwierania pliku.
- Gdy w innym przypadku potrzebujesz ręcznej kontroli nad ustawieniami Google Cloud projektu.
Standardowe właściwości projektu Cloud
Projekty standardowe mają te właściwości:
- Dostęp do wszystkich ustawień Google Cloud dla projektu możesz uzyskać bezpośrednio w konsoli Google Cloud. Dzięki temu możesz aktywować interfejsy API, dostosować dane uwierzytelniające autoryzacji i skonfigurować inne szczegóły.
- Gdy usuniesz projekt skryptu lub przełączysz go na inny projekt standardowy, pierwotny projekt standardowy pozostanie i będzie można go używać ponownie.
- Po aktywowaniu usługi zaawansowanej w projekcie skryptu musisz ręcznie aktywować odpowiedni interfejs API w projekcie standardowym.
- Ten sam standardowy projekt może być wspólny dla wielu projektów skryptów i innych aplikacji. Jeśli chcesz opublikować projekt skryptu jako dodatek w Google Workspace Marketplace, musi on mieć własny projekt standardowy. Opublikowane aplikacje nie mogą udostępniać projektów Google Cloud innym aplikacjom.
- Jeśli chcesz uruchamiać funkcje w projekcie skryptu z innej aplikacji za pomocą metody
scripts.run
interfejsu Apps Script API, projekt skryptu i aplikacja wywołująca muszą mieć ten sam projekt standardowy. - Gdy Apps Script prosi użytkownika o autoryzację skryptu wykorzystującego projekt standardowy, do identyfikacji skryptu służy nazwa projektu Cloud, a nie nazwa projektu skryptu. Z tego względu ustaw odpowiednią nazwę projektu Cloud.
Dostęp do standardowego projektu Cloud
Aby uzyskać dostęp do standardowego projektu powiązanego z projektem skryptu, wykonaj te czynności:
- Otwórz projekt Apps Script.
- Po lewej stronie kliknij Ustawienia projektu .
- W sekcji Projekt Google Cloud Platform (GCP) kliknij numer projektu.
Projekt standardowy znajdziesz też bezpośrednio na stronie Zarządzanie zasobami w konsoli Google Cloud.
Aktywowanie interfejsu API w standardowym projekcie Cloud
Często aplikacja Apps Script wymaga dostępu do innego interfejsu API Google. Aby to zrobić, musisz aktywować interfejs API w odpowiednim projekcie Cloud. Aktywuj interfejs API, wykonując te czynności:
- Otwórz projekt Cloud.
- Kliknij Menu > Interfejsy API i usługi.
- Kliknij Włącz interfejsy API i usługi.
- W polu wyszukiwania wpisz interfejs API, który chcesz aktywować, i naciśnij Enter.
- Kliknij interfejs API w wynikach wyszukiwania, a następnie kliknij Włącz, aby aktywować interfejs API w tym projekcie Cloud.
Może pojawić się prośba o zaakceptowanie Warunków korzystania z interfejsów API Google lub Google Cloud. Przeczytaj je uważnie, zanim je zaakceptujesz.
W zależności od aplikacji może być też konieczne skonfigurowanie interfejsu API przez jego wybranie w panelu Interfejsy API i usługi.
Określanie identyfikatora i numeru standardowego projektu Cloud
Wszystkie projekty Cloud mają nazwę, identyfikator i numer projektu. Czasami jest on potrzebny do skonfigurowania usług lub wykonania innych zadań.
Aby określić identyfikator i numer projektu standardowego, wykonaj te czynności:
- Otwórz projekt Cloud.
- W prawym górnym rogu kliknij Więcej > Ustawienia projektu.
- W wyświetlonym panelu Ustawienia wyświetl Nazwę projektu, Identyfikator projektu i Numer projektu. Numer projektu składa się tylko z cyfr, a identyfikator projektu jest alfanumeryczny. Możesz edytować nazwę projektu, która jest wyświetlana użytkownikom podczas próśb o autoryzację.
Wyświetlanie logów i raportów o błędach Google Cloud w konsoli Google Cloud
Jeśli w projekcie skryptu używasz logowania w Google Cloud lub raportowania błędów, możesz wyświetlić te logi i raporty w konsoli Google Cloud, wykonując te czynności:
- Otwórz projekt Cloud.
- Kliknij Menu .
- Przewiń w dół do sekcji Operacje i kliknij Logowanie > Eksplorator logów.
- Aby wyświetlić raporty o błędach, przewiń w dół do sekcji Operacje i kliknij Raportowanie błędów. Jeśli pojawi się prośba o skonfigurowanie raportowania błędów, oznacza to, że Twój projekt skryptu nie zarejestrował jeszcze żadnych wyjątków.
Wypełnij ekran zgody OAuth
W przypadku korzystania z usług wymagających OAuth Google prosi użytkowników o autoryzację tych usług. Ustawienia ekranu zgody OAuth pozwalają określić niektóre informacje, które Google przedstawia użytkownikom, np. nazwę aplikacji i adres URL Warunków korzystania z usługi.
Domyślne projekty Cloud automatycznie tworzą ekran zgody na podstawie szczegółów projektu Apps Script. Nie możesz zmienić tych ustawień. Te informacje można dostosowywać w standardowych projektach Cloud. Aby skonfigurować ekran zgody w skrypcie, wykonaj te czynności:
- Otwórz projekt Cloud.
- Kliknij Menu > Interfejsy API i usługi > Dane logowania.
- Kliknij Skonfiguruj ekran zgody.
- Wypełnij wszystkie sekcje procedury na ekranie zgody.
- Aby rejestrować zmiany na każdym etapie przepływu pracy, kliknij Zapisz i kontynuuj.
Tworzenie danych logowania OAuth
Apps Script zwykle konfiguruje OAuth dla usług, których używa Twój skrypt. W przypadku niektórych aplikacji trzeba utworzyć dodatkowe dane uwierzytelniające protokołu OAuth (identyfikatory klientów i tajne klucze klienta). Jest to możliwe tylko w przypadku standardowych projektów.
Aby utworzyć identyfikator klienta i tajny klucz klienta na potrzeby projektu skryptu, wykonaj te czynności:
- Otwórz projekt Cloud.
- Kliknij Menu > Interfejsy API i usługi > Dane logowania.
- Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
- W sekcji Typ aplikacji wybierz typ aplikacji i w razie potrzeby wypełnij wynikowy formularz. Gdy skończysz, kliknij Utwórz.
- W wyświetlonym oknie kliknij Pobierz JSON. Za pomocą tego pliku możesz skonfigurować OAuth.
Dodawanie dodatkowych właścicieli do standardowego projektu Cloud
Do standardowego projektu możesz dodać dodatkowych właścicieli lub inne role. Jeśli współpracujesz nad projektem, dzięki temu ktoś z Twojego zespołu ma zawsze dostęp do ustawień Google Cloud projektu skryptu.
Aby dodać do standardowego projektu dodatkowych właścicieli lub inne role, wykonaj te czynności. Aby wprowadzić dowolne z tych zmian, musisz mieć uprawnienia do edycji w projekcie:
- Określ, kim mają być Twoi współpracownicy. Zalecamy utworzenie lub użycie istniejącej grupy dyskusyjnej Google. Możesz też określić domeny na liście współpracowników, aby uwzględnić wszystkich użytkowników w danej domenie.
- Otwórz projekt Cloud skryptu.
- Kliknij Menu > Administracja > Uprawnienia.
- U góry kliknij Dodaj.
- Aby dodać do projektu Cloud co najmniej 1 użytkownika i jego rolę, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie. Jako nowych użytkowników możesz dodawać poszczególne adresy e-mail, grupy dyskusyjne Google lub domeny.
- Kliknij Zapisz.
Grupowanie wielu skryptów w jednym projekcie Cloud
Wiele projektów Apps Script może używać tego samego standardowego projektu Cloud. Aby to zrobić, utwórz standardowy projekt, a potem przełącz na niego każdy projekt skryptu. Nie można tego zrobić w projektach domyślnych.
Użyj innego standardowego projektu Cloud
Możesz przełączyć projekt skryptu tak, aby używał innego standardowego projektu Cloud. Jeśli Twój skrypt wymaga ręcznej konfiguracji projektu Cloud, musisz przełączyć się z projektu domyślnego na projekt standardowy. Aby dowiedzieć się, kiedy trzeba użyć standardowego projektu, przeczytaj artykuł o standardowych projektach Cloud.
Skutki przejścia na inny standardowy projekt Cloud
Zmiana skryptu z projektu domyślnego lub innego projektu standardowego będzie miała takie skutki:
- Jeśli aktywowano usługi zaawansowane dla skryptu, musisz włączyć odpowiednie interfejsy API w nowym projekcie Cloud. Utracisz wszystkie dane powiązane z zaawansowanymi usługami w poprzednim projekcie Cloud. Aby dowiedzieć się, jak włączyć interfejsy API w projekcie Cloud, przeczytaj artykuł Włączanie interfejsów Google Workspace API.
- Jeśli skrypt korzysta z wbudowanej usługi Dysku Google, musisz włączyć interfejs Drive API w standardowych projektach Cloud.
Włącz interfejs Drive API w swoim standardowym projekcie Cloud:
- Wszyscy użytkownicy, którzy wcześniej autoryzowali skrypt, muszą przeprowadzić autoryzację ponownie. W większości przypadków wszyscy użytkownicy, którzy wcześniej autoryzowali aplikacje powiązane z nowym projektem, muszą jeszcze raz autoryzować aplikacje.
- Jeśli skrypt jest powiązany z informacjami o aplikacji w Google Workspace Marketplace, informacje o aplikacji, użytkownicy i opinie nie zostaną przeniesione do nowego projektu. Musisz utworzyć stronę z informacjami o aplikacji w nowym projekcie, a użytkownicy będą musieli ponownie zainstalować aplikację. Informacje o tworzeniu nowych informacji o aplikacji znajdziesz w artykule Publikowanie aplikacji.
- Nie możesz przełączyć skryptu z powrotem na projekt domyślny. Apps Script usuwa projekty domyślne po ustawieniu w skrypcie na potrzeby standardowego projektu.
Przełącz się na inny standardowy projekt Cloud
Aby przenieść istniejący projekt Cloud skryptu do innego projektu Cloud, wykonaj te czynności:
- Jeśli nie masz odpowiedniego projektu Cloud, utwórz go, postępując zgodnie z instrukcjami tworzenia projektu. Ustaw łatwą do zapamiętania nazwę projektu, aby można ją było znaleźć na stronie Zarządzanie zasobami w konsoli Google Cloud. Apps Script używa tej nazwy, gdy prosi użytkowników o autoryzację skryptu.
- Jeśli chcesz użyć istniejącego projektu, otwórz stronę Zarządzanie zasobami w konsoli Google Cloud i znajdź istniejący projekt, którego chcesz użyć. Musisz mieć w projekcie przypisaną rolę przeglądarki projektu i edytującego konfigurację OAuth lub role z odpowiednimi uprawnieniami. Nie możesz użyć projektu, który został automatycznie utworzony przez Apps Script.
- Określ numer projektu Cloud projektu.
- Otwórz skrypt, którego projekt Cloud chcesz zastąpić.
- Po lewej stronie kliknij Ustawienia projektu .
- W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
- Wpisz nowy numer projektu i kliknij Ustaw projekt.
Projekty w chmurze i dyski współdzielone
Dyski współdzielone (wcześniej Dyski zespołu) to miejsca współdzielone, w których grupy użytkowników Dysku mogą współpracować nad projektami Apps Script i dokumentami na Dysku. Dyski współdzielone są przydatne przy tworzeniu przez zespół skryptów, dodatków i aplikacji internetowych, ale nakładają pewne ograniczenia na to, co można zrobić w przypadku starszych domyślnych projektów Cloud.
Na liście ograniczeń opisano, jak projekty Cloud współdziałają z dyskami współdzielonymi:
- Jeśli Twój projekt skryptu korzysta z projektu standardowego, nie obowiązują żadne dodatkowe ograniczenia, gdy projekt skryptu znajduje się na dysku współdzielonym.
- Jeśli projekt skryptu używa domyślnego projektu, który został utworzony 8 kwietnia 2019 roku lub później, nie obowiązują żadne dodatkowe ograniczenia, jeśli projekt skryptu znajduje się na dysku współdzielonym.
- Jeśli projekt skryptu korzysta z projektu domyślnego, który został utworzony przed 8 kwietnia 2019 roku, w czasie, gdy projekt skryptu znajduje się na dysku współdzielonym, obowiązują te ograniczenia:
- Do domyślnego projektu nie można uzyskać dostępu za pomocą interfejsu użytkownika Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia wykonywanie działań, które wymagają bezpośredniego dostępu do projektu.
- Nie możesz aktywować usług zaawansowanych. Aby aktywować usługi zaawansowane, przełącz się na projekt standardowy.
- Gdy przeniesiesz istniejący projekt Apps Script na dysk współdzielony, Google ogranicza dostęp do domyślnego projektu Cloud. Nadal będziesz mieć dostęp do projektu domyślnego, jeśli przed przeniesieniem miałeś do niego dostęp. Jeśli na przykład utworzysz skrypt w folderze Mój dysk, a potem przeniesiesz go na dysk współdzielony, nadal będziesz mieć dostęp do projektu Google Cloud. Twoi współpracownicy na dysku współdzielonym mogą nie mieć uprawnień.
- Skrypt zachowuje nazwę projektu Cloud sprzed przeniesienia na dysk współdzielony. Nawet jeśli zmienisz nazwę projektu na dysku współdzielonym, użytkownicy, którzy autoryzują skrypt, nadal będą widzieć starą nazwę w oknach autoryzacji.
Aby uniknąć powyższych ograniczeń w przypadku starszych skryptów, przełącz się na projekt standardowy.
Pobieranie listy projektów Apps Script w chmurze
Jeśli masz uprawnienia resourcemanager.projects.list
do folderu projektu Apps Script swojej organizacji, możesz wyświetlić wszystkie standardowe i domyślne projekty Apps Script Cloud w tym folderze.
- Otwórz stronę Zarządzanie zasobami w konsoli Google Cloud.
- Skopiuj identyfikator znajdujący się obok folderu Apps Script.
- Kliknij Filtr > Identyfikator nadrzędny i wklej identyfikator folderu Apps Script.
Usuwanie projektów Cloud Apps Script
Aby usunąć projekt Apps Script Cloud, wykonaj czynności opisane w sekcji Wyświetlanie listy projektów Apps Script Cloud, wybierz projekt do usunięcia i kliknij Usuń.
Aby usunąć projekt Apps Script za pomocą gcloud
, użyj tych poleceń.
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
Więcej informacji o usuwaniu projektów Cloud znajdziesz w artykule Wyłączanie (usuwanie) projektów.