La dashboard di Apps Script ti consente di gestire e monitorare i tuoi progetti Apps Script. Utilizza la dashboard per:
- Visualizza e cerca i tuoi progetti Apps Script esistenti, inclusi gli script associati ai documenti Google 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 per i tuoi progetti e per 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 sono di tua proprietà, 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.
Visualizza dettagli 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 del 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 account utente 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 precedente ai dati e ai grafici; seleziona 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 di Apps Script.
I progetti pubblicati come componenti aggiuntivi non vengono visualizzati come deployment nella dashboard Apps Script.
Monitorare i progetti
Aggiungi i progetti ai preferiti contrassegnandoli con una stella. Se aggiungi progetti ai preferiti, puoi anche monitorare statistiche e grafici aggregati sull'utilizzo e sul tasso di errore.
Per aggiungere una stella a un progetto, fai clic su Altro a destra di una riga del progetto > Aggiungi stella. Puoi anche aggiungere un progetto ai preferiti facendo clic su Altro mentre visualizzi i dettagli del progetto.
Nel menu di navigazione a sinistra, seleziona 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.
Rimuovi una stella da un progetto facendo clic su Altro nella riga del progetto e selezionando Rimuovi stella.
Gestire le esecuzioni
Utilizza la dashboard Apps Script per visualizzare e gestire le singole esecuzioni delle funzioni del progetto Apps Script. Per visualizzare un log completo delle esecuzioni recenti, seleziona Le mie esecuzioni nel menu di navigazione a sinistra.
Il riquadro Le mie esecuzioni mostra un log di tutte le esecuzioni precedenti e in corso 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 delle esecuzioni mostra solo la funzione iniziale chiamata per avviare l'esecuzione. Non mostra ogni funzione chiamata durante l'esecuzione.
Controlla 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. 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:
- 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 in corso sono indicate da uno stato "In esecuzione". Per interrompere queste esecuzioni, fai clic su Altro > Termina a destra della riga del progetto.
Impostazioni
Modifica le impostazioni della dashboard selezionando Impostazioni nel menu di navigazione a sinistra.
Nel riquadro Impostazioni è presente 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 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 tuoi 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. Revoca questo accesso in qualsiasi momento nel pannello Impostazioni.
Per ulteriori informazioni, consulta la guida all'accesso all'API Apps Script.