Panel Apps Script umożliwia zarządzanie projektami Apps Script i ich monitorowanie. W panelu możesz:
- 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świetl szczegółowe informacje o projektach, takie jak zakresy OAuth, których używa.
- 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
Panel Apps Script zawiera wszystkie projekty skryptów, które możesz wyświetlać i edytować. W lewym panelu nawigacji te projekty są podzielone 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 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
W każdym projekcie dostępny jest widok, w którym można wyświetlić szczegółowe informacje o nim przez dewelopera. 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 wykonań, które nie zostały wykonane z powodu niewykrytych wyjątków. Jest ona obliczana jako liczba nieudanych wykonań podzielona przez łączną liczbę wykonań w określonym okresie.
- Uruchomienia. Liczba uruchomień lub wykonania projektu. Więcej informacji o sposobie uruchamiania projektu znajdziesz w sekcji 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, więc nie są odzwierciedlane w liczbach 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 oznaczeniem 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ę. Możesz też oznaczyć projekt gwiazdką, klikając Więcej podczas wyświetlania szczegółów projektu.
W panelu nawigacyjnym po lewej stronie możesz wybrać Projekty oznaczone gwiazdką, by wyświetlić projekty dodane do zakładek. Kliknij kartę wyników Współczynnik błędów, Wykonania lub Użytkownicy u góry strony, aby wyświetlić powiązane wykresy dotyczące wszystkich projektów oznaczonych gwiazdką w ciągu ostatnich 7 dni.
Aby usunąć gwiazdkę z projektu, w jego wierszu kliknij Więcej 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. Ta lista może też zawierać wykonania funkcji w projektach, do których nie masz dostępu, jeśli są uruchamiane w Twoim imieniu (np. zainstalowane i uruchomione dodatki). Lista wykonania zawiera tylko początkową funkcję, która jest wywoływana, aby rozpocząć wykonanie. Nie zawiera ona wszystkich funkcji, które były wywoływane podczas wykonania.
Za pomocą filtrów u góry widoku możesz określić, jaki typ wykonania jest raportowany w logu. Każdy wiersz logu odpowiada 1 wykonaniu. Kolumny Godzina rozpoczęcia, Czas trwania i Stan zawierają odpowiednie informacje o tym wykonaniu.
Kolumna Funkcja zawiera nazwę 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łączone. Wykonywanie pochodzi z dodatku.
- Execution API. Wykonanie zostało wywołane przez interfejs Apps Script API.
- Upływ czasu. Wykonywanie zostało wywołane przez zdarzenie czasowe.
- Aktywator. Wykonanie pochodzi ze źródła aktywatora.
- Webapp. Wykonanie pochodziło z wdrożonej aplikacji internetowej.
- Edytujący. Wykonanie pochodzi z edytora Apps Script.
Zakończ wykonywanie
Długo trwające wykonania, które są w toku, mają stan „Uruchomiono”. 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. Dostęp do projektów skryptów jest domyślnie wyłączony ze względów bezpieczeństwa. 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.