Panel Apps Script umożliwia zarządzanie projektami Apps Script i ich monitorowanie. W panelu możesz:
- Wyświetlanie i wyszukiwanie istniejących projektów Apps Script, w tym powiązanych skryptów dołączonych doGoogle Workspace dokumentów.
- 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świetlaj logi wykonania dotyczące projektów i innych projektów korzystających z danych logowania z Twojego konta.
- Włącz lub wyłącz Apps Script API, aby zezwolić aplikacjom na interakcję z projektami skryptów lub go zablokować.
Wyświetl i wyszukuj projekty
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 monitoring.
- Moje projekty. Projekty, których jesteś właścicielem.
- Wszystkie projekty. Projekty, których jesteś właścicielem albo w przypadku których masz uprawnienia do wyświetlania lub edycji.
- Udostępnione dla mnie. Projekty, które nie należą do Ciebie, ale zostały Ci udostępnione.
- Kosz. Projekty usunięte przez Ciebie z Dysku Google.
Listy projektów zawierają nazwę projektu, właściciela i datę ostatniej modyfikacji. Ikony obok nazwy projektu wskazują, czy jest on projektem samodzielnym czy powiązanym.
Wyświetl szczegóły 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 wiersz na liście projektów.
Widok szczegółów projektu zawiera dane i wykresy Odsetek błędów, wykonania i użytkowników, a także zakresy protokołu OAuth żądane od każdego użytkownika korzystającego z projektu. Dane są zdefiniowane w ten sposób:
- Odsetek błędów. Odsetek wykonań, które nie zostały wykonane z powodu niewykrytych wyjątków. Wartość tę oblicza się, dzieląc liczbę nieudanych wykonań przez łączną liczbę wykonań w zdefiniowanym 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 co najmniej 1 raz uruchomili projekt w określonym przedziale czasu. Użytkownicy anonimowi nie są śledzeni, więc nie są odzwierciedlane w liczbach ani na wykresach.
Każde wdrożenie projektu jest widoczne na stronie Szczegóły projektu nad danymi i wykresami. Możesz ją kliknąć, aby zobaczyć powiązane dane dotyczące tego wdrożenia. Wybranie opcji WSZYSTKO powoduje wyświetlenie danych zbiorczych wszystkich wdrożeń projektu oraz wykonań pochodzących od programistów uruchamiających projekt z poziomu edytora kodu Apps Script.
Monitorowanie projektów
Możesz mieć dostęp do znacznie większej liczby projektów Apps Script niż regularnie używasz lub którymi zarządzasz. Aby dodać projekty do zakładek, aby mieć do nich łatwy dostęp, możesz oznaczyć je gwiazdką. Oznaczanie projektów gwiazdką pozwala też monitorować zbiorcze statystyki wykorzystania i odsetka błędów oraz wykresy w tych projektach.
Aby oznaczyć projekt gwiazdką, po prawej stronie wiersza projektu kliknij Więcej > Dodaj gwiazdkę. Możesz też oznaczyć projekt gwiazdką, klikając Więcej przy wyświetlaniu 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 Odsetek błędów, Wykonania lub Użytkownicy u góry strony, aby wyświetlić powiązane wykresy dotyczące wszystkich oznaczonych gwiazdką projektów w ciągu ostatnich 7 dni.
Aby usunąć gwiazdkę z projektu, kliknij Więcej w wierszu projektu i wybierz Usuń gwiazdkę.
Zarządzaj wykonaniami
W panelu Apps Script możesz wyświetlać poszczególne uruchomienia funkcji projektu Apps Script i nimi zarządzać. Pełny dziennik ostatnich uruchomień znajdziesz, wybierając Moje wykonania w panelu nawigacyjnym po lewej stronie.
Panel Moje wykonania zawiera domyślnie dziennik wszystkich poprzednich i obecnie uruchomionych wykonań projektów, których jesteś właścicielem, edytującym lub przeglądającym. 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 wykonań zawiera tylko funkcję początkową, która jest wywoływana w celu rozpoczęcia wykonania. Nie pokazuje wszystkich funkcji wywołanych podczas tego 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 Czas rozpoczęcia, Czas trwania i Stan zawierają odpowiednie informacje o wykonaniu.
Kolumna Funkcja zawiera nazwę funkcji, która zainicjowała wykonanie. Jeśli nie masz dostępu do odpowiedniego projektu skryptu wykonania, ale został on uruchomiony w Twoim imieniu, ta kolumna nie zawiera nazwy.
Kolumna Typ pokazuje, co zainicjowało wykonanie. Dostępne wartości:
- Dodatek. Wykonanie pochodzi z dodatku.
- Execution API. Wykonanie zostało zapoczątkowane przez wywołanie interfejsu Apps Script API.
- Upływ czasu. Wykonanie zostało spowodowane zdarzeniem w czasie.
- Wyzwalacz. Wykonanie pochodzi ze źródła aktywatora.
- Aplikacja internetowa. Wykonanie pochodziło z wdrożonej aplikacji internetowej.
- Edytujący. Wykonanie zostało zainicjowane z edytora Apps Script.
Zakończ wykonania
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
Aby dostosować ustawienia panelu, kliknij Ustawienia w panelu nawigacyjnym po lewej stronie.
W panelu Ustawienia znajduje się przełącznik Apps Script API. Pozwoli Ci to 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 ostrzeżenia i przełącznikem. Dostęp do projektów skryptów jest domyślnie wyłączony ze względów bezpieczeństwa. Gdy przyznasz dostęp, każda autoryzowana aplikacja innej firmy będzie mogła używać interfejsu API do modyfikowania skryptów i wdrożeń. W każdej chwili możesz anulować ten dostęp w panelu Ustawienia.
Więcej informacji znajdziesz w przewodniku po dostępie do interfejsu Apps Script API.