La dashboard di Apps Script ti consente di gestire e monitorare i tuoi progetti Apps Script. Puoi utilizzare la dashboard per eseguire una delle seguenti operazioni:
- Visualizzare e cercare i progetti Apps Script esistenti, inclusi gli script collegati allegati ai documenti.
- Creare nuovi progetti.
- Visualizza i dettagli dei tuoi progetti, ad esempio gli ambiti OAuth utilizzati.
- Monitora l'integrità e l'utilizzo dei progetti di script.
- Visualizza i log di esecuzione dei tuoi progetti e di altri eseguiti utilizzando le credenziali del tuo account.
- Attiva o disattiva l'API Apps Script per consentire o impedire alle app di utilizzare l'API per interagire con i tuoi progetti di script.
Visualizzare e cercare progetti
La dashboard di Apps Script elenca tutti i progetti di script che puoi visualizzare o modificare. Il riquadro di navigazione a sinistra della dashboard suddivide questi progetti nelle seguenti categorie:
- Progetti contrassegnati come Speciali. I progetti che monitori.
- I miei progetti. Progetti di cui sei proprietario.
- Tutti i progetti. Progetti di tua proprietà o per i quali disponi delle autorizzazioni di visualizzazione o modifica.
- Condivisi con me. Progetti che non sono di tua proprietà, ma che sono stati condivisi con te.
- Cestino. Progetti che hai rimosso da Google Drive.
Gli elenchi dei progetti mostrano il nome, il proprietario e la data dell'ultima modifica del progetto. Le icone accanto al nome del progetto indicano se si tratta di un progetto autonomo o vincolato.
Visualizza i dettagli del progetto
Ogni progetto include una visualizzazione per visualizzare i dettagli dello sviluppatore. Per visualizzare i dettagli di un progetto, fai clic sulla riga nell'elenco dei progetti.
La visualizzazione dei dettagli del progetto mostra i dati e i grafici relativi a Tasso di errori, Esecuzioni e Utenti del progetto, nonché gli ambiti OAuth richiesti a qualsiasi utente finale che utilizza il progetto. Le metriche dei dati sono definite come segue:
- Tasso di errore. La percentuale di esecuzioni non riuscite a causa di eccezioni non rilevate. Viene calcolato dividendo le esecuzioni non riuscite per le esecutioni totali nel periodo di tempo definito.
- Esecuzioni. Il numero di volte in cui un progetto è stato "eseguito" o eseguito. Consulta Tipi di esecuzione per saperne di più su come eseguire un progetto.
- Utenti. Il numero di utenti (account) unici che hanno eseguito il progetto una o più volte nel periodo di tempo specificato. Gli utenti anonimi non vengono monitorati e pertanto non vengono conteggiati nei grafici o nel numero di utenti.
Ogni implementazione del progetto viene visualizzata come scheda nella pagina Dettagli progetto sopra i dati e i grafici. Puoi selezionare la scheda per visualizzare i dati associati a quell'implementazione. Se selezioni TUTTE, vengono visualizzati i dati aggregati per tutti i deployment e le esecuzioni del progetto derivanti dall'esecuzione del progetto da parte degli sviluppatori nell'editor di codice di Apps Script.
Monitorare i progetti
Potresti avere accesso a molti più progetti Apps Script di quelli che utilizzi o gestisci regolarmente. Per aggiungere i progetti ai preferiti e accedervi facilmente, puoi metterli in primo piano. Mettere i progetti in primo piano ti consente anche di monitorare le statistiche e i grafici sull'utilizzo e sul tasso di errori aggregati di questi progetti.
Per aggiungere un progetto a Speciali, fai clic su Altro > Aggiungi a Speciali a destra della riga del progetto. Puoi anche aggiungere un progetto a Speciali facendo clic su Altro mentre visualizzi i dettagli del progetto.
Nel menu di navigazione a sinistra, puoi selezionare Progetti con stelle per visualizzare i progetti che hai aggiunto ai preferiti. Fai clic sulla scheda del prospetto Tasso di errori, Esecuzioni o Utenti nella parte superiore della pagina per visualizzare i grafici associati per tutti i progetti contrassegnati negli ultimi 7 giorni.
Puoi rimuovere una stella da un progetto facendo clic su Altro nella riga del progetto e selezionando Rimuovi stella.
Gestire le esecuzioni
Puoi utilizzare la dashboard di Apps Script per visualizzare e gestire le singole esecuzioni delle funzioni del progetto Apps Script. Puoi trovare un log completo delle esecuzioni recenti selezionando l'elemento Le mie esecuzioni nel menu di navigazione a sinistra.
Per impostazione predefinita, il riquadro Le mie esecuzioni mostra un log di tutte le esecuzioni precedenti e in esecuzione per i progetti di cui sei proprietario, editor o visualizzatore. Questo elenco può includere anche le esecuzioni di funzioni in progetti a cui non hai accesso se vengono eseguite per tuo conto (ad esempio, i componenti aggiuntivi che hai installato ed eseguito). L'elenco di esecuzione mostra solo la funzione iniziale invocata per avviare l'esecuzione. Non mostra tutte le funzioni che sono state chiamate durante l'esecuzione.
Puoi controllare il tipo di esecuzione registrato nel log utilizzando i filtri nella parte superiore della visualizzazione. Ogni riga del log rappresenta una singola esecuzione. Le colonne Ora di inizio, Durata e Stato mostrano le informazioni corrispondenti sull'esecuzione.
La colonna Funzione mostra il nome della funzione che ha avviato l'esecuzione. In questa colonna non è presente alcun nome se non hai accesso al progetto di script corrispondente all'esecuzione, ma è stato eseguito per tuo conto.
La colonna Tipo mostra cosa ha avviato l'esecuzione. I valori includono:
- Componente aggiuntivo. L'esecuzione ha avuto origine da un componente aggiuntivo.
- API Execution. L'esecuzione è stata avviata da un'invocazione dell'API Apps Script.
- In base al tempo. L'esecuzione è stata causata da un evento di tempo.
- Trigger. L'esecuzione ha avuto origine da un'origine trigger.
- Webapp. L'esecuzione ha avuto origine da un'app web di cui è stato eseguito il deployment.
- Editor. L'esecuzione è iniziata dall'editor di Apps Script.
Terminare le esecuzioni
Le esecuzioni a lunga esecuzione attualmente in corso sono indicate da un stato "In esecuzione". Per interrompere queste esecuzioni, a destra della riga del progetto, fai clic su Altro > Termina.
Impostazioni
Puoi modificare le impostazioni della dashboard selezionando Impostazioni nel menu di navigazione a sinistra.
Nel riquadro Impostazioni è presente un'opzione di attivazione/disattivazione per l'API Apps Script. In questo modo puoi concedere all'API l'accesso ai tuoi progetti di script.
Per accedere a questo pulsante di attivazione/disattivazione, fai clic sull'etichetta API Google Apps Script nel riquadro Impostazioni. Si aprirà un nuovo riquadro con un testo di avviso e un pulsante di attivazione/disattivazione. L'accesso ai progetti di script è disattivato per impostazione predefinita come misura di sicurezza. Una volta concesso l'accesso, qualsiasi applicazione di terze parti che autorizzi può utilizzare l'API per modificare gli script e i deployment. Puoi revocare questo accesso in qualsiasi momento nel riquadro Impostazioni.
Scopri di più nella guida all'accesso all'API Apps Script.