La dashboard di Apps Script

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 gli script associati allegati aiGoogle Workspace documenti.
  • Creare nuovi progetti.
  • Visualizzare i dettagli dei 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 che vengono eseguiti utilizzando le credenziali del tuo account.
  • Attiva o disattiva l'API Apps Script per consentire o impedire alle app di usare 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 questi 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 di 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 il progetto è un progetto autonomo o associato.

Visualizza i dettagli del progetto

Ogni progetto include una visualizzazione per vedere i dettagli dello sviluppatore sul progetto. Per visualizzare i dettagli di un progetto, fai clic sulla riga nell'elenco dei progetti.

La visualizzazione dei dettagli del progetto mostra dati e grafici relativi a Percentuale di errore, Esecuzioni e Utenti relativi al progetto, nonché gli ambiti OAuth richiesti a qualsiasi utente finale che utilizza il progetto. Le metriche dei dati sono definite come segue:

  • Percentuale di errore. La percentuale di esecuzioni non riuscite a causa di eccezioni non rilevate. Questo valore 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" o eseguito. Consulta Tipi di esecuzione per ulteriori informazioni su come eseguire 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 inclusi nel conteggio o nei grafici degli utenti.

Ogni deployment del progetto viene visualizzato come scheda nella pagina Dettagli del progetto sopra i dati e i grafici; puoi selezionare la scheda per visualizzare i dati associati a tale implementazione. Se selezioni TUTTI, vengono mostrati i dati aggregati per tutti i deployment del progetto e delle esecuzioni risultanti dagli sviluppatori che hanno eseguito il progetto nell'editor di codice di Apps Script.

Monitora progetti

Potresti avere accesso a molti più progetti Apps Script di quelli che utilizzi o gestisci regolarmente. Puoi aggiungere progetti a Speciali per aggiungerli ai preferiti e accedervi facilmente. L'aggiunta dei progetti a Speciali consente inoltre di monitorare le statistiche e i grafici aggregati sull'utilizzo e sul tasso di errore di tali progetti.

Per aggiungere un progetto a Speciali, fai clic su Altro > Aggiungi a Speciali a destra della riga di un 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 aggiunti a Speciali per visualizzare i progetti aggiunti ai preferiti. Fai clic sulla scheda punteggi Percentuale di errore, Esecuzioni o Utenti nella parte superiore della pagina per visualizzare i grafici associati a tutti i progetti aggiunti a 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 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.

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 eseguiti 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 tutte le funzioni chiamate 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 esiste un nome in questa colonna se non hai accesso al progetto di script corrispondente dell'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 ha avuto origine da una chiamata all'API Apps Script.
  • Basato sul tempo. L'esecuzione è stata causata da un evento ora.
  • Attivatore. L'esecuzione ha avuto origine da un'origine di 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 da uno 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 pulsante di attivazione/disattivazione per l'API Apps Script. Questo consente di concedere all'API l'accesso ai 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 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 autorizzata potrà utilizzare l'API per modificare gli script e i deployment. Puoi revocare questo accesso in qualsiasi momento nel riquadro Impostazioni.

Puoi trovare ulteriori informazioni nella guida di accesso all'API Apps Script.