La dashboard di Apps Script consente di gestire e monitorare i progetti Apps Script. Puoi utilizzare la dashboard per eseguire una delle seguenti operazioni:
- Visualizza e cerca i progetti Apps Script esistenti, inclusi script legati allegati aiGoogle Workspace documenti.
- Creare nuovi progetti.
- Visualizza i dettagli dei tuoi progetti, ad esempio gli ambiti OAuth che utilizza.
- Monitora l'integrità e l'utilizzo dei tuoi progetti di script.
- Visualizza i log di esecuzione per i tuoi progetti e altri che vengono 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.
Visualizza e cerca progetti
La dashboard di Apps Script elenca tutti i progetti di script che puoi visualizzare o modificare. Il menu di navigazione sinistro della dashboard suddivide i progetti nelle seguenti categorie:
- Progetti aggiunti a Speciali. I progetti che stai monitoring.
- I miei progetti. I progetti di cui sei proprietario.
- Tutti i progetti. I progetti di tua proprietà o per i quali disponi delle autorizzazioni di visualizzazione o modifica.
- Condivisi con me. I progetti che non sono di tua proprietà, ma che sono stati condivisi con te.
- Cestino. I progetti che hai rimosso da Google Drive.
Gli elenchi di 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 degli sviluppatori relativi al progetto. 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 alla percentuale di errori, alle esecuzioni e agli utenti, nonché gli ambiti OAuth richiesti da qualsiasi utente finale che utilizza il progetto. Le metriche dei dati sono definite come segue:
- Percentuale di errori. La percentuale di esecuzioni non riuscite a causa di eccezioni non rilevate. Viene calcolato dividendo le esecuzioni non riuscite per il totale delle esecuzioni nel periodo di tempo definito.
- Esecuzioni. Il numero di volte in cui un progetto è stato "eseguito" o eseguito. Consulta la sezione Tipi di esecuzione per ulteriori informazioni su come può essere eseguito un progetto.
- Utenti. Il numero di utenti unici (account) che hanno eseguito il progetto una o più volte nel periodo di tempo specificato. Gli utenti anonimi non vengono monitorati e pertanto non vengono presi in considerazione nel conteggio o nei grafici degli utenti.
Ogni deployment del progetto viene visualizzato come una scheda nella pagina Dettagli progetto sopra i dati e i grafici; puoi selezionare la scheda per visualizzare i dati associati al deployment. Se selezioni TUTTI, vengono mostrati i dati aggregati per tutti i deployment del progetto e le esecuzioni derivanti dagli sviluppatori che eseguono il progetto dall'editor di codice di Apps Script.
Monitora progetti
Potresti avere accesso a un numero notevolmente maggiore di progetti Apps Script di quanti ne utilizzi o gestisci regolarmente. Per aggiungere i progetti ai preferiti per un facile accesso, puoi aggiungerli a Speciali. L'aggiunta dei progetti a Speciali consente inoltre di monitorare statistiche e grafici sull'utilizzo e sul tasso di errore aggregati su tali progetti.
Per aggiungere un progetto a Speciali, a destra della riga del progetto, fai clic su Altro > Aggiungi a Speciali. Puoi anche aggiungere un progetto a Speciali facendo clic su Altro durante la visualizzazione dei dettagli del progetto.
Nel menu di navigazione a sinistra, puoi selezionare Progetti speciali per visualizzare i progetti aggiunti ai preferiti. Fai clic sulla scheda punteggi Percentuale di errori, Esecuzioni o Utenti nella parte superiore della pagina per visualizzare i grafici associati di tutti i progetti speciali negli ultimi 7 giorni.
Per rimuovere un progetto da Speciali, fai clic su Altro nella riga del progetto e seleziona Rimuovi da Speciali.
Gestisci 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 la voce My Executions 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ò anche includere 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 delle esecuzioni mostra solo la funzione iniziale richiamata per avviare l'esecuzione. Non mostra tutte le funzioni chiamate durante l'esecuzione.
Puoi controllare il tipo di esecuzione segnalato nel log utilizzando i filtri nella parte superiore della vista. 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. Questa colonna non contiene alcun nome se non hai accesso al progetto di script corrispondente dell'esecuzione, ma è stato eseguito per tuo conto.
La colonna Tipo mostra ciò che ha avviato l'esecuzione. I valori includono:
- Componente aggiuntivo. L'esecuzione ha avuto origine da un componente aggiuntivo.
- API Execution. L'esecuzione ha avuto origine da una chiamata dell'API Apps Script.
- Basato sul tempo. L'esecuzione è stata causata da un evento temporale.
- Attiva. L'esecuzione ha avuto origine da un'origine trigger.
- App web. L'esecuzione ha avuto origine da un'app web di cui è stato eseguito il deployment.
- Editor. L'esecuzione ha avuto origine dall'editor di Apps Script.
Termina esecuzioni
Le esecuzioni a lunga esecuzione attualmente in corso sono indicate dallo stato "In esecuzione". Per interrompere queste esecuzioni, fai clic su Altro > Termina a destra della riga del progetto.
Impostazioni
Puoi modificare le impostazioni della dashboard selezionando Impostazioni nel menu di navigazione a sinistra.
Nel riquadro Impostazioni è disponibile un pulsante 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 questa opzione, fai clic sull'etichetta API Google Apps Script nel riquadro Impostazioni. Si apre un nuovo riquadro con testo di avviso e un'opzione di attivazione/disattivazione. Per impostazione predefinita, l'accesso ai progetti di script è disattivato come precauzione di sicurezza. Una volta concesso l'accesso, qualsiasi applicazione di terze parti autorizzata può utilizzare l'API per modificare script e deployment. Puoi revocare questo accesso in qualsiasi momento nel riquadro Impostazioni.
Ulteriori informazioni sono disponibili nella guida all'accesso all'API Apps Script.