La dashboard 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 tuoi progetti Apps Script esistenti, inclusi gli script associati ai documentiGoogle Workspace .
- Crea nuovi progetti.
- Visualizza i dettagli dei tuoi progetti, ad esempio gli ambiti OAuth che utilizza.
- Monitora lo stato e l'utilizzo dei tuoi 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 menu di navigazione a sinistra della dashboard suddivide questi progetti nelle seguenti categorie:
- Progetti contrassegnati come Speciali. Progetti che stai monitorando.
- 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 ti appartengono, ma che sono stati condivisi con te.
- Cestino. I progetti che hai rimosso da Google Drive.
Gli elenchi dei progetti mostrano il nome, il proprietario e la data dell'ultima modifica. Le icone accanto al nome del progetto indicano se il progetto è autonomo o associato.
Visualizzare i dettagli del progetto
Ogni progetto include una visualizzazione per vedere 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 errore, 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 che non sono state eseguite a causa di eccezioni non rilevate. Viene calcolato dividendo le esecuzioni non riuscite per il numero totale di esecuzioni nel periodo di tempo definito.
- Esecuzioni. Il numero di volte in cui un progetto è stato "eseguito". Per saperne di più su come può essere eseguito un progetto, consulta Tipi di esecuzione.
- 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 o visualizzati nei grafici.
Ogni deployment del progetto viene visualizzato come scheda nella pagina Dettagli progetto sopra i dati e i grafici. Puoi selezionare la scheda per visualizzare i dati associati a quel deployment. Se selezioni TUTTI, vengono visualizzati i dati aggregati di tutti i deployment del progetto e delle esecuzioni risultanti dall'esecuzione del progetto da parte degli sviluppatori all'interno dell'editor di codice 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 contrassegnarli con una stella. Se aggiungi progetti ai preferiti, puoi anche monitorare le statistiche e i grafici aggregati sull'utilizzo e sul tasso di errore di questi progetti.
Per aggiungere una stella a un progetto, fai clic su Altro > Aggiungi stella a destra di una riga del progetto. Puoi anche aggiungere un progetto a Speciali facendo clic su Altro mentre visualizzi i dettagli del progetto.
Nel riquadro di navigazione a sinistra, puoi selezionare Progetti speciali per visualizzare i progetti che hai aggiunto ai preferiti. Fai clic sul prospetto Tasso di errore, Esecuzioni o Utenti nella parte superiore della pagina per visualizzare i grafici associati a tutti i tuoi progetti preferiti 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 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.
Il riquadro Le mie esecuzioni mostra per impostazione predefinita un log di tutte le esecuzioni precedenti e attualmente 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, componenti aggiuntivi che hai installato ed eseguito). L'elenco di esecuzione mostra solo la funzione iniziale chiamata per avviare l'esecuzione. Non mostra ogni funzione chiamata durante l'esecuzione.
Puoi controllare il tipo di esecuzione riportato 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. Non è presente alcun nome in questa colonna se non hai accesso al progetto di script corrispondente all'esecuzione, ma è stato eseguito per tuo conto.
La colonna Tipo mostra l'elemento che ha avviato l'esecuzione. I valori includono:
- Aggiungi componente aggiuntivo. L'esecuzione ha avuto origine da un componente aggiuntivo.
- API Execution. L'esecuzione ha avuto origine da una chiamata all'API Apps Script.
- Time Driven. L'esecuzione è stata causata da un evento temporale.
- 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 ha avuto origine dall'editor Apps Script.
Termina esecuzioni
Le esecuzioni a lunga esecuzione attualmente in corso sono indicate dallo 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 apre un nuovo riquadro con il testo di avviso e un pulsante di attivazione/disattivazione. L'accesso ai progetti di script è disattivato per impostazione predefinita come precauzione di sicurezza. Una volta concesso l'accesso, qualsiasi applicazione di terze parti che autorizzi può utilizzare l'API per modificare i tuoi script e deployment. Puoi revocare questo accesso in qualsiasi momento nel pannello Impostazioni.
Per ulteriori informazioni, consulta la guida all'accesso all'API Apps Script.