Panel Apps Script umożliwia zarządzanie projektami Apps Script i ich monitorowanie. W panelu możesz wykonywać te czynności:
- wyświetlać i wyszukiwać istniejące projekty Apps Script, w tym powiązane skrypty dołączone doGoogle Workspace dokumentów;
- tworzyć nowe projekty;
- Wyświetl szczegółowe informacje o projektach, takie jak używane przez nie zakresy OAuth.
- Monitoruj stan i wykorzystanie projektów skryptów.
- Wyświetl logi wykonania dotyczące Twoich projektów i innych projektów uruchamianych z użyciem danych logowania Twojego konta.
- Włącz lub wyłącz Apps Script API, aby zezwolić aplikacjom na interakcję z projektami skryptu lub uniemożliwić aplikacjom korzystanie z interfejsu API.
Wyświetl i wyszukaj projekty
Panel Apps Script zawiera listę wszystkich projektów skryptu, 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 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 to projekt samodzielny, czy powiązany.
Wyświetl szczegóły projektu
Każdy projekt zawiera widok umożliwiający wyświetlenie informacji o deweloperze w danym projekcie. Aby wyświetlić szczegóły projektu, kliknij wiersz na liście projektów.
Widok szczegółów projektu zawiera odsetek błędów, wykonania i użytkowników, a także wykresy dotyczące projektu, a także zakresy OAuth żądane w przypadku wszystkich użytkowników korzystających z projektu. Dane te są zdefiniowane w ten sposób:
- Odsetek błędów. Odsetek uruchomień, których nie udało się wykonać z powodu niewykrytych wyjątków. Jest ona obliczana jako liczba nieudanych wykonań podzielona przez łączną liczbę wykonań w wybranym okresie.
- Wykonania. Liczba przypadków uruchomienia lub wykonania projektu. Więcej informacji o uruchamianiu projektu znajdziesz w sekcji Typy wykonania.
- Użytkownicy. Liczba unikalnych użytkowników (kont), którzy uruchomili projekt co najmniej raz w danym okresie. Anonimowi użytkownicy nie są śledzeni i nie są uwzględniani na wykresach ani liczbie użytkowników.
Każde wdrożenie projektu jest wyświetlane jako karta na stronie Szczegóły projektu nad danymi i wykresami. Możesz ją kliknąć, aby zobaczyć dane powiązane z tym wdrożeniem. Wybranie opcji WSZYSTKO powoduje wyświetlenie zbiorczych danych dotyczących wszystkich wdrożeń w projekcie oraz wykonań przez 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, których regularnie używasz lub którymi zarządzasz. Jeśli chcesz dodać projekty do zakładek i mieć do nich łatwy dostęp, oznacz je gwiazdką. Oznaczanie projektów gwiazdkami 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ę. Aby oznaczyć projekt gwiazdką, kliknij Więcej podczas wyświetlania szczegółów projektu.
W panelu nawigacyjnym po lewej stronie możesz kliknąć Projekty oznaczone gwiazdką, by zobaczyć projekty dodane do zakładek. Kliknij Odsetek błędów, Uruchomienia lub Użytkownicy u góry strony, aby wyświetlić wykresy powiązane ze wszystkimi projektami oznaczonymi gwiazdką w ciągu ostatnich 7 dni.
Aby usunąć gwiazdkę z projektu, kliknij Więcej w wierszu tego projektu i wybierz Usuń gwiazdkę.
Zarządzanie 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 element Moje wykonania w panelu nawigacyjnym po lewej stronie.
Panel Moje wykonania domyślnie wyświetla dziennik wszystkich wcześniejszych i aktywnych uruchomień projektów, których jesteś właścicielem, edytującym lub przeglądającym. Ta lista może też zawierać uruchomienia funkcji w projektach, do których nie masz dostępu, jeśli działają w Twoim imieniu (np. zainstalowane i uruchomione dodatki). Lista uruchomień zawiera tylko początkową funkcję wywoływaną w celu rozpoczęcia wykonania. Nie pokazuje wszystkich funkcji, które zostały wywołane podczas tego wykonania.
Za pomocą filtrów u góry widoku możesz kontrolować, jaki typ wykonania ma być uwzględniany 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, który został uruchomiony w Twoim imieniu, nie ma nazwy w tej kolumnie.
Kolumna Typ pokazuje, co zainicjowało wykonanie. Dostępne wartości:
- Dodatek. Uruchomienie pochodziło z dodatku.
- Execution API – Wykonanie pochodzi z wywołania interfejsu Apps Script API.
- Time Driven (Przebieg czasu). Wykonanie zostało spowodowane zdarzeniem czasowym.
- Wyzwalacz. Wykonanie pochodzi ze źródła aktywatora.
- Aplikacja internetowa. Wykonanie pochodzi z wdrożonej aplikacji internetowej.
- Edytujący. Wykonanie skryptu pochodzi z edytora Apps Script.
Zakończ uruchomienia
Długo trwające wykonania, które są obecnie w toku, są oznaczone stanem „Uruchomiono”. Aby zatrzymać te uruchomienia, po prawej stronie wiersza projektu kliknij Więcej > Zakończ.
Ustawienia
Ustawienia panelu możesz dostosować, klikają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 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łącznikiem. Ze względów bezpieczeństwa dostęp do projektów skryptu jest domyślnie wyłączony. Po przyznaniu dostępu każda autoryzowana aplikacja innej firmy może 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 interfejsie Apps Script API.