W panelu Apps Script możesz zarządzać projektami Apps Script i nimi zarządzać. Korzystając z panelu, możesz:
- Wyświetl i wyszukaj istniejące projekty Apps Script, w tym powiązane skrypty dołączone doGoogle Workspace dokumentów.
- tworzyć nowe projekty;
- Wyświetl szczegóły dotyczące projektów, na przykład zakresy OAuth.
- Monitorowanie stanu i wykorzystania projektów skryptu.
- Wyświetl logi wykonania projektów i innych, które korzystają z Twoich danych logowania na konto.
- Włącz lub wyłącz interfejs Apps Script API, aby zezwolić aplikacjom na korzystanie z niego podczas interakcji z projektami skryptu.
Wyświetlanie i wyszukiwanie projektów
Panel Apps Script zawiera wszystkie projekty skryptu, które możesz wyświetlać lub edytować. Panel 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 do 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 z Dysku Google.
Listy projektów zawierają nazwę, właściciela i datę ostatniej modyfikacji. Ikony obok nazwy projektu wskazują, czy jest on samodzielny, czy przypisany.
Wyświetl szczegóły projektu
W każdym projekcie znajduje się widok, w którym możesz zobaczyć informacje o deweloperze. Aby wyświetlić szczegóły projektu, kliknij wiersz z listy projektów.
Widok szczegółów projektu zawiera dane na temat odsetka błędów, wykonań i użytkowników, a także wykresy dotyczące zakresów protokołu OAuth dowolnego użytkownika końcowego korzystającego z projektu. Dane są definiowane w ten sposób:
- Częstotliwość błędów. Odsetek uruchomień, których nie udało się wykonać z powodu niewypełnionych wyjątków. Wartość tę oblicza się, dzieląc liczbę nieudanych uruchomień przez łączną liczbę uruchomień w określonym czasie.
- Uruchomienia. Liczba przypadków wykonania i wykonania projektu. Więcej informacji o wykonywaniu projektów znajdziesz w artykule Typy wykonywania.
- Użytkownicy. Liczba unikalnych użytkowników, którzy uruchomili projekt co najmniej raz w danym okresie. Anonimowi użytkownicy nie są śledzeni, dlatego nie są uwzględniani w liczbie użytkowników ani na wykresach.
Każde wdrożenie projektu pojawia się na karcie Na stronie szczegółów projektu nad danymi i wykresami. Możesz wybrać kartę, aby wyświetlić powiązane dane wdrożenia. Wybranie opcji WSZYSTKIE pokazuje zbiorcze dane o wszystkich wdrożeniach projektu i wykonaniach wykonywanych przez deweloperów uruchamiających projekt za pomocą edytora kodu Apps Script.
Monitorowanie projektów
Możesz mieć dostęp do znacznie większej liczby projektów Apps Script niż zwykle lub którymi zarządzasz. Aby dodawać projekty do zakładek, aby mieć do nich łatwy dostęp, możesz je oznaczyć gwiazdką. Projekty oznaczone gwiazdką umożliwiają też monitorowanie zbiorczych statystyk dotyczących użytkowania i błędów 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 podczas wyświetlania szczegółów projektu.
W panelu nawigacyjnym po lewej stronie możesz wybrać Projekty oznaczone gwiazdką, aby zobaczyć projekty, które zostały dodane do zakładek. U góry strony kliknij kartę Współczynnik błędów, Wykonywanie lub Użytkownicy, aby wyświetlić powiązane wykresy dla wszystkich projektów oznaczonych gwiazdką w ciągu ostatnich 7 dni.
Aby usunąć gwiazdkę z projektu, kliknij Więcej w wierszu projektu i wybierz Usuń gwiazdkę.
Zarządzanie wykonaniami
Możesz użyć panelu Apps Script, aby wyświetlić poszczególne wykonania funkcji projektu Apps Script i nimi zarządzać. Pełny dziennik ostatnich uruchomień znajdziesz, wybierając element Moje wykonania w panelu nawigacyjnym po lewej stronie.
Panel Moje wykonania domyślnie pokazuje dziennik wszystkich poprzednich i obecnie uruchomionych projektów, których jesteś właścicielem, edytorem lub przeglądającym. Ta lista może również obejmować wykonania funkcji w projektach, do których nie masz dostępu, na przykład w przypadku dodatków, które zostały zainstalowane i uruchomione. Lista wykonania zawiera tylko funkcję początkową, która jest wywoływana w celu uruchomienia wykonania. Nie pokazuje ona wszystkich funkcji, które zostały wywołane podczas tego wykonania.
Za pomocą filtrów u góry widoku możesz kontrolować, jakiego rodzaju wykonanie jest rejestrowane w logu. Każdy wiersz logu reprezentuje jedno wykonanie. Kolumny Godzina rozpoczęcia, Czas i Stan zawierają informacje o wykonania.
Kolumna Funkcja zawiera nazwę funkcji, która spowodowała wykonanie kodu. W tej kolumnie nie ma nazwy, jeśli nie masz dostępu do odpowiadającego mu projektu skryptu, ale został uruchomiony w Twoim imieniu.
Kolumna Typ pokazuje, co uruchomiło wykonanie. Dostępne wartości:
- Dodaj. Wykonanie nastąpiło z dodatku.
- Interfejs Execution API. Uruchomienie pochodzi z wywołania interfejsu Apps Script API.
- Czas jazdy. Wykonanie zostało spowodowane zdarzeniem czasu.
- Reguła. Wykonanie pochodzi ze źródła aktywatora.
- Aplikacja internetowa. Uruchomienie pochodzi z wdrożonej aplikacji internetowej.
- Edytor. Uruchomienie pochodzi z edytora Apps Script.
Zakończ wykonania
Bieżące trwające wykonania są oznaczone za pomocą stanustanu "bieg". Aby zatrzymać wykonywanie tych poleceń, po prawej stronie wiersza projektu kliknij Więcej > Zakończ.
Ustawienia
Możesz dostosować ustawienia panelu, wybierając Ustawienia w panelu 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 skryptu.
Aby przejść do tego przełącznika, kliknij etykietę Google Apps Script API w panelu Ustawienia. Otworzy się nowy panel z tekstem ostrzeżenia i przełącznikiem. Ze względów bezpieczeństwa dostęp do projektów skryptu jest domyślnie wyłączony. Gdy przyznasz dostęp, każda autoryzowana aplikacja innej firmy będzie mogła korzystać z interfejsu API do modyfikowania skryptów i wdrożeń. W każdej chwili możesz unieważnić ten dostęp w panelu Ustawienia.
Więcej informacji znajdziesz w przewodniku po dostępie do interfejsu API Apps Script.
Pomoc
Jeśli zauważysz błąd lub potrzebujesz pomocy dotyczącej korzystania z panelu Apps Script, zacznij od wyszukania witryny na stronie Stack Overflow:
Błędy
Jeśli ustalisz, że przyczyna problemu wynika z błędu w panelu, możesz wyszukiwać nasz moduł do śledzenia problemów, aby sprawdzić, czy jest to znany problem. Jeśli tak, możesz oznaczyć problem gwiazdką (kliknij gwiazdkę obok numeru problemu). Błędy, które otrzymują więcej gwiazdek, traktujemy priorytetowo. Możesz też dodawać komentarze do dotychczasowych problemów, ale warto robić to tylko wtedy, gdy dodajesz kontekst lub dodatkowe informacje o problemie.
Jeśli problem jest całkowicie nowy, możesz też zgłosić go w narzędziu do śledzenia problemów. Jeśli tak, podaj w opisie błędu te informacje:
- Opis problemu i oczekiwane działanie.
- Lista kroków, które mogą spowodować odtworzenie problemu.
- Opis oczekiwanych danych wyjściowych i tego, co się tak naprawdę stało. Dołącz wszystkie wyświetlane komunikaty o błędach.
- Informacje o środowisku programistycznym, w tym język programowania, wersje biblioteki itp.
Pamiętaj, że problemy mogą być stosunkowo ciche. Nie oznacza to, że nigdy nie rozwiążemy problemu, a jedynie brak aktualizacji.
Brakujące funkcje
Jeśli w dashboadach brakuje jakichś funkcji lub funkcji, możesz przesłać narzędzie do śledzenia problemów, aby sprawdzić, czy inni użytkownicy o nie poprosili. Jeśli prośba została już wysłana, oznacz ją gwiazdką (kliknij gwiazdkę obok numeru problemu). W pierwszej kolejności wybieramy błędy, które otrzymują więcej gwiazdek. Możesz też dodawać komentarze do istniejących problemów, ale warto to zrobić tylko wtedy, gdy dodajesz kontekst lub dodatkowe informacje o problemie.
Jeśli prośba o dodanie funkcji nie została jeszcze wysłana, możesz przesłać prośbę o dodanie jej do narzędzia do śledzenia problemów. Opisz konkretne funkcje, które Twoim zdaniem powinny być dodane, oraz powody, dla których uważasz, że są to ważne. W miarę możliwości podaj szczegółowe informacje o przypadku użycia i o nowych możliwościach, jakie daje dana funkcja.