Panel Apps Script umożliwia zarządzanie projektami Apps Script i ich monitorowanie. Za pomocą panelu możesz wykonywać te czynności:
- Wyświetlanie istniejących projektów Apps Script i wyszukiwanie ich, w tym powiązanych skryptów dołączonych do dokumentówGoogle Workspace .
- tworzyć nowe projekty;
- Wyświetlaj szczegóły projektów, np. zakresy uprawnień OAuth, których używają.
- Monitorowanie stanu i wykorzystania projektów skryptów.
- Wyświetlanie logów wykonania Twoich projektów i innych projektów, które są uruchamiane za pomocą danych logowania do Twojego konta.
- Włącz lub wyłącz interfejs Apps Script API, aby zezwolić aplikacjom na korzystanie z interfejsu API do interakcji z Twoimi projektami skryptów lub zabronić im tego.
Wyświetlanie i wyszukiwanie projektów
W panelu Apps Script znajdziesz listę wszystkich projektów skryptów, które możesz wyświetlać lub edytować. Nawigacja po lewej stronie panelu dzieli te projekty na te kategorie:
- Projekty oznaczone gwiazdką. projekty, które monitorujesz;
- Moje projekty. projekty, których jesteś właścicielem;
- Wszystkie projekty. projekty, których jesteś właścicielem lub w przypadku których masz uprawnienia do wyświetlania lub edytowania;
- Udostępnione dla mnie. Projekty, które nie należą do Ciebie, ale zostały Ci udostępnione.
- Kosz. projekty usunięte z Dysku Google.
Na listach projektów widnieje nazwa projektu, jego właściciel i data ostatniej modyfikacji. Ikony obok nazwy projektu wskazują, czy jest to projekt samodzielny czy powiązany.
Wyświetlanie szczegółów projektu
Każdy projekt zawiera widok, w którym można zobaczyć informacje o nim dla deweloperów. Aby wyświetlić szczegóły projektu, kliknij jego wiersz na liście projektów.
Widok szczegółów projektu zawiera dane i wykresy dotyczące częstości występowania błędów, uruchomień oraz użytkowników, a także zakresy uprawnień OAuth żądane przez dowolnego użytkownika korzystającego z projektu. Dane są definiowane w ten sposób:
- Współczynnik błędów. Odsetek uruchomień, które nie powiodły się z powodu nieprzechwyczonej obsługi wyjątków. Jest ona obliczana jako liczba nieudanych wykonań podzielona przez łączną liczbę wykonań w określonym okresie.
- Uruchomienia. Liczba przypadków uruchomienia lub wykonania projektu. Więcej informacji o sposobach uruchamiania projektu znajdziesz w artykule Typy wykonania.
- Użytkownicy. Liczba unikalnych użytkowników (kont), którzy uruchomili projekt co najmniej raz w wybranym okresie. Użytkownicy anonimowi nie są śledzeni, dlatego nie są uwzględniani w liczbie użytkowników ani na wykresach.
Każde wdrożenie projektu jest widoczne jako karta na stronie Szczegóły projektu nad danymi i wykresami. Możesz kliknąć tę kartę, aby wyświetlić powiązane z tym wdrożeniem dane. Wybranie opcji WSZYSTKIE powoduje wyświetlenie danych zbiorczych dotyczących wszystkich wdrożeń projektu oraz jego uruchomień przez deweloperów w edytorze kodu Apps Script.
Monitorowanie projektów
Możesz mieć dostęp do znacznie większej liczby projektów Apps Script niż tych, których używasz lub którymi zarządzasz regularnie. Aby mieć łatwy dostęp do projektów, możesz je oznaczyć gwiazdką. Dzięki oznaczeniu gwiazdką możesz też monitorować zbiorcze statystyki dotyczące użytkowania i współczynnika błędów oraz wykresy dotyczące tych projektów.
Aby oznaczyć projekt gwiazdką, po prawej stronie jego wiersza kliknij Więcej > Dodaj gwiazdkę. Projekt możesz też oznaczyć gwiazdką, klikając Więcej podczas wyświetlania szczegółów projektu.
W menu nawigacyjnym po lewej stronie możesz wybrać Oznaczone projekty, aby wyświetlić zapisane w zakładkach projekty. Kliknij kartę wyników Współczynnik błędów, Wykonania lub Użytkownicy u góry strony, aby wyświetlić powiązane wykresy dla wszystkich projektów oznaczonych gwiazdką z ostatnich 7 dni.
Aby usunąć gwiazdkę z projektu, kliknij Więcej w jego wierszu i wybierz Usuń gwiazdkę.
Zarządzanie wykonaniami
W panelu Apps Script możesz wyświetlać poszczególne wykonania funkcji projektu Apps Script i nimi zarządzać. Aby zobaczyć pełny dziennik ostatnich wykonań, wybierz element Moje wykonania w menu nawigacyjnym po lewej stronie.
Panel Moje wykonania zawiera domyślnie log wszystkich poprzednich i obecnie uruchomionych wykonań w projektach, w których jesteś właścicielem, edytorem lub widzem. Lista może też zawierać funkcje uruchamiane w projektach, do których nie masz dostępu, jeśli są one wykonywane w Twoim imieniu (np. dodatki, które zostały zainstalowane i uruchamiane). Lista wykonania zawiera tylko początkową funkcję, która jest wywoływana, aby rozpocząć wykonanie. Nie zawiera ona wszystkich funkcji, które zostały wywołane podczas wykonania.
Za pomocą filtrów u góry widoku możesz określić, który typ wykonania ma być raportowany w dzienniku. Każdy wiersz dziennika odpowiada jednemu wykonaniu. Kolumny Godzina rozpoczęcia, Czas trwania i Stan zawierają odpowiednie informacje o tym wykonaniu.
W kolumnie Funkcja widnieje nazwa funkcji, która zainicjowała wykonanie. Jeśli nie masz dostępu do projektu skryptu odpowiadającego wykonaniu, ale został on uruchomiony w Twoim imieniu, w tej kolumnie nie będzie nazwy.
Kolumna Typ wskazuje, co zapoczątkowało wykonanie. Dostępne wartości:
- Dodaj Wł. Wykonywanie pochodzi z dodatku.
- Execution API. Wykonanie zostało wywołane przez interfejs Apps Script API.
- Czas napędzany. Wykonywanie zostało wywołane przez zdarzenie czasowe.
- Aktywator. Wykonanie pochodzi ze źródła aktywatora.
- Aplikacja internetowa. Wykonywanie pochodzi z wdrożonej aplikacji internetowej.
- Edytujący. Wykonanie pochodzi z edytora Apps Script.
Zakończ wykonywanie
Długotrwałe uruchomienia, które są obecnie w toku, są oznaczone stanem „Uruchomione”. Aby zatrzymać te wykonania, po prawej stronie wiersza projektu kliknij Więcej > Zakończ.
Ustawienia
Ustawienia panelu możesz dostosować, wybierając Ustawienia w menu nawigacyjnym po lewej stronie.
W panelu Ustawienia znajduje się przełącznik interfejsu Apps Script API. Dzięki temu możesz przyznać interfejsowi API dostęp do projektów skryptów.
Aby uzyskać dostęp do tego przełącznika, kliknij etykietę Google Apps Script API w panelu Ustawienia. Otworzy się nowy panel z tekstem ostrzegawczym i przełącznikiem. Ze względów bezpieczeństwa dostęp do projektów skryptów jest domyślnie wyłączony. Gdy przyznasz dostęp, każda aplikacja innej firmy, którą autoryzujesz, może używać interfejsu API do modyfikowania Twoich skryptów i wdrożeń. W każdej chwili możesz cofnąć ten dostęp w panelu Ustawienia.
Więcej informacji znajdziesz w przewodniku po dostępie do interfejsu Apps Script API.