La dashboard di Apps Script consente di gestire e monitorare i progetti Apps Script. Utilizza la dashboard per:
- Visualizzare e cercare i progetti Apps Script esistenti, inclusi gli script associati ai documenti di Google Workspace.
- Creare nuovi progetti.
- Visualizzare i dettagli dei progetti, ad esempio gli ambiti OAuth utilizzati.
- Monitorare l'integrità e l'utilizzo dei progetti di script.
- Visualizzare i log di esecuzione dei tuoi progetti e di altri che vengono eseguiti utilizzando le credenziali del tuo account.
- Attivare o disattivare l'API Apps Script per consentire o impedire alle app di utilizzare l'API per interagire con i progetti di script.
Visualizzare e cercare i 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 aggiunti a Speciali. Progetti che stai monitorando.
- I miei progetti. Progetti di cui sei proprietario.
- Tutti i progetti. Progetti di cui sei proprietario o per i quali disponi delle autorizzazioni di visualizzazione o modifica.
- Condiviso con me. Progetti di cui non sei proprietario, ma che sono stati condivisi con te.
- Cestino. Progetti che hai rimosso da Google Drive.
Gli elenchi dei progetti mostrano il nome del progetto, il proprietario e la data dell'ultima modifica. Le icone accanto al nome del progetto indicano se si tratta di un progetto autonomo o di un progetto associato.
Visualizzare i dettagli del progetto
Ogni progetto include una visualizzazione per vedere i dettagli dello sviluppatore del progetto. Per visualizzare i dettagli di un progetto, fai clic sulla riga nell'elenco dei progetti.
La visualizzazione dei dettagli del progetto mostra Tasso di errore, Esecuzioni e Utenti dati e grafici relativi al 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 riuscite a essere eseguite a causa di eccezioni non rilevate. Viene calcolata 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". Per saperne di più su come eseguire un progetto, consulta la sezione 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 visualizzati nel conteggio o nei grafici degli utenti.
Ogni deployment del progetto viene visualizzato come scheda nella pagina Dettagli progetto prima dei dati e dei 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 di Apps Script.
Monitorare i progetti
Aggiungi i progetti ai preferiti contrassegnandoli con una stella. Contrassegnare i progetti con una stella consente anche di monitorare le statistiche e i grafici aggregati sull'utilizzo e sul tasso di errore.
Per contrassegnare un progetto con una stella, fai clic su Altro > Aggiungi a Speciali a destra della riga del progetto. Puoi anche contrassegnare un progetto con una stella facendo clic su Altro mentre visualizzi i dettagli del progetto.
Nel menu di navigazione a sinistra, seleziona Progetti aggiunti a Speciali per visualizzare i progetti che hai aggiunto ai preferiti. Fai clic sul riquadro punteggio Tasso di errore, Esecuzioni o Utenti nella parte superiore della pagina per visualizzare i grafici associati di tutti i progetti aggiunti a Speciali negli ultimi 7 giorni.
Per rimuovere una stella da un progetto, fai clic su Altro nella riga del progetto e seleziona Rimuovi da Speciali.
Gestire le esecuzioni
Utilizza la dashboard di Apps Script per visualizzare e gestire le singole esecuzioni delle funzioni del progetto Apps Script. Per trovare 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 dei 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 tutte le funzioni chiamate durante l'esecuzione.
Controlla il tipo di esecuzione segnalato 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:
- 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.
- Basata sul tempo. L'esecuzione è stata causata da un evento temporale.
- Trigger. L'esecuzione ha avuto origine da una sorgente di trigger.
- Applicazione 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 script di Apps Script.
Terminare le esecuzioni
Le esecuzioni a lunga durata in corso sono indicate dallo Stato "In corso". 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. Viene aperto un nuovo riquadro con un testo di avviso e un pulsante di attivazione/disattivazione. Per precauzione, l'accesso ai progetti di script è disattivato per impostazione predefinita. Una volta concesso l'accesso, qualsiasi applicazione di terze parti autorizzata può utilizzare l'API per modificare gli script e i deployment. Puoi revocare questo accesso in qualsiasi momento nel riquadro Impostazioni.
Per saperne di più, consulta la guida all'accesso all'API Apps Script.