Panel Apps Script umożliwia zarządzanie projektami Apps Script i monitorowanie ich. W panelu możesz wykonywać te czynności:
- Wyświetlanie i wyszukiwanie istniejących projektów Apps Script, w tym powiązanych skryptów dołączonych do dokumentów Google Workspace.
- tworzyć nowe projekty,
- Wyświetlaj szczegóły projektów, takie jak używane przez nie zakresy OAuth.
- Monitorowanie stanu i wykorzystania projektów skryptów.
- Wyświetlanie logów wykonania projektów i innych projektów, które są uruchamiane przy użyciu danych logowania Twojego konta.
- Włącz lub wyłącz Apps Script API, aby zezwolić aplikacjom na używanie interfejsu API do interakcji z projektami skryptów lub temu zapobiec.
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ć. Lewy panel nawigacyjny 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 widoczne są nazwa projektu, właściciel i data ostatniej modyfikacji. Ikony obok nazwy projektu wskazują, czy jest to samodzielny czy powiązany projekt.
Wyświetlanie szczegółów projektu
Każdy projekt zawiera widok, w którym można zobaczyć szczegóły dewelopera dotyczące projektu. Aby wyświetlić szczegóły projektu, kliknij wiersz na liście projektów.
Widok szczegółów projektu zawiera dane i wykresy dotyczące współczynnika błędów, uruchomień i użytkowników projektu, a także zakresy OAuth, o które proszeni są użytkownicy korzystający z projektu. Dane są zdefiniowane w ten sposób:
- Współczynnik błędu Odsetek wykonań, które nie zostały uruchomione z powodu nieobsłużonych wyjątków. Oblicza się go, dzieląc liczbę nieudanych wykonań przez łączną liczbę wykonań w określonym czasie.
- Uruchomienia Liczba uruchomień lub wykonania projektu. Więcej informacji o sposobach uruchamiania projektu znajdziesz w sekcji Typy wykonania.
- Użytkownicy Liczba unikalnych użytkowników (kont), którzy uruchomili projekt co najmniej raz w określonym przedziale czasu. Anonimowi użytkownicy nie są śledzeni, dlatego nie są uwzględniani w liczbie użytkowników ani na wykresach.
Każde wdrożenie projektu jest wyświetlane jako karta na stronie Szczegóły projektu nad danymi i wykresami. Możesz wybrać kartę, aby zobaczyć powiązane z nią dane. Wybranie opcji WSZYSTKIE powoduje wyświetlenie danych zbiorczych dotyczących wszystkich wdrożeń projektu i wykonań wynikających z uruchamiania projektu 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ż używasz lub którymi zarządzasz na co dzień. Aby dodać projekty do zakładek i mieć do nich łatwy dostęp, możesz oznaczyć je gwiazdką. Oznaczanie projektów gwiazdką umożliwia też monitorowanie zbiorczych statystyk wykorzystania i współczynnika błędów oraz wykresów dotyczących tych projektów.
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 menu po lewej stronie możesz wybrać Projekty z gwiazdką, aby wyświetlić projekty, które zostały przez Ciebie dodane do zakładek. U góry strony kliknij kartę wyników Odsetek błędów, Wykonania lub Użytkownicy, aby wyświetlić powiązane wykresy wszystkich projektów oznaczonych gwiazdką z ostatnich 7 dni.
Aby usunąć gwiazdkę z projektu, kliknij Więcej w wierszu projektu 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ć. Pełny dziennik ostatnich wykonań znajdziesz, wybierając Moje wykonania w menu po lewej stronie.
Panel Moje wykonania domyślnie wyświetla dziennik wszystkich poprzednich i obecnie trwających wykonań projektów, w których jesteś właścicielem, edytującym lub przeglądającym. Ta lista może też obejmować wykonania funkcji w projektach, do których nie masz dostępu, jeśli są one uruchamiane w Twoim imieniu (np. zainstalowane i uruchomione przez Ciebie dodatki). Na liście wykonania wyświetlana jest tylko początkowa funkcja, która jest wywoływana 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 określić, jaki typ wykonania ma być raportowany w dzienniku. Każdy wiersz dziennika reprezentuje pojedyncze wykonanie. Kolumny Godzina rozpoczęcia, Czas trwania i Stan zawierają odpowiednie informacje o tym wykonaniu.
W kolumnie Funkcja wyświetla się 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 pokazuje, co zainicjowało wykonanie. Dostępne wartości:
- Dodaj. Uruchomienie pochodzi z dodatku.
- Execution API. Wykonanie zostało zainicjowane przez wywołanie interfejsu Apps Script API.
- Czas jazdy Wykonanie zostało spowodowane przez zdarzenie czasowe.
- Aktywator Wykonanie pochodzi ze źródła aktywatora.
- Aplikacja internetowa Wykonanie pochodzi z wdrożonej aplikacji internetowej.
- Edytujący Wykonanie zostało zainicjowane w edytorze Apps Script.
Zakończ wykonywanie
Długotrwałe wykonania, które są obecnie w toku, są oznaczone stanem „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 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 ostrzeżenia 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 autoryzowana aplikacja innej firmy może używać interfejsu API do modyfikowania 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.