La dashboard di Apps Script

La dashboard di Apps Script consente di gestire e di monitorare i progetti Apps Script. Puoi utilizzare la dashboard per eseguire le seguenti:

  • Visualizza e cerca i tuoi progetti Apps Script esistenti, tra cui script bound allegati a Google Workspace documenti.
  • Creare nuovi progetti.
  • Visualizza i dettagli dei tuoi progetti, ad esempio 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 e credenziali.
  • 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 modifica. Il menu di navigazione sinistro della dashboard suddivide i progetti nei seguenti: categorie:

  • Progetti aggiunti a Speciali. I progetti che stai monitorando.
  • 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. 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. La accanto al nome del progetto indicano se si tratta di un autonomo o un progetto vincolato.

Visualizza i dettagli del progetto

Ogni progetto include una visualizzazione per visualizzare i dettagli degli sviluppatori relativi al progetto. A visualizzare i dettagli di un progetto, fai clic sulla riga nell'elenco dei progetti.

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

  • Percentuale di errori. La percentuale di esecuzioni non riuscite a causa di non rilevate. Viene calcolata dividendo le esecuzioni non riuscite per il numero esecuzioni totali nel periodo di tempo definito.
  • Esecuzioni. Il numero di volte in cui un progetto è stato "eseguito" o eseguiti. Consulta la sezione Tipi di esecuzione per ulteriori informazioni su come di eseguire il progetto.
  • Utenti. Il numero di utenti unici (account) che hanno eseguito il progetto uno o volte più volte nel periodo di tempo specificato. Gli utenti anonimi non vengono monitorati e pertanto non sono visibili nel conteggio o nei grafici degli utenti.

Ogni deployment del progetto viene visualizzato come scheda nella scheda Dettagli progetto pagina sopra i dati e i grafici; puoi selezionare la scheda e vedere i dati associati al deployment. Se selezioni TUTTI, i programmi aggregare i dati di tutti i deployment del progetto e delle esecuzioni derivanti dall'esecuzione del progetto dall'interno di Apps Script dell'editor di codice.

Monitora progetti

Potresti avere accesso a un numero notevolmente maggiore di progetti Apps Script di quelli che utilizzi o gestire regolarmente. Per aggiungere i progetti ai preferiti per un facile accesso, puoi aggiungerli a Speciali. L'aggiunta dei progetti a Speciali consente anche di monitorare le statistiche aggregate sull'utilizzo e sul tasso di errore e grafici su questi progetti.

Per aggiungere un progetto a Speciali, fai clic su Altro a destra della riga del progetto > Aggiungi a Speciali. Per aggiungere un progetto a Speciali puoi anche fare clic su Altro durante la visualizzazione dei dettagli del progetto.

Nel menu di navigazione a sinistra, puoi selezionare Progetti aggiunti a Speciali per visualizzare i progetti. che hai aggiunto ai preferiti. Fai clic su Percentuale di errori, Esecuzioni o Utenti. prospetto nella parte superiore della pagina per visualizzare i grafici associati per tutte le progetti aggiunti a Speciali negli ultimi 7 giorni.

Puoi rimuovere un progetto da Speciali facendo clic su Altro nella riga del progetto e selezionando 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 dei dati esecuzioni selezionando la voce My Executions (Le mie esecuzioni) nel menu di navigazione a sinistra.

Per impostazione predefinita, il riquadro Le mie esecuzioni mostra un log di tutte le esecuzioni precedenti e attuali esecuzioni per progetti di cui sei proprietario, editor o visualizzatore. L'elenco può includere anche le esecuzioni di funzioni nei progetti non hanno accesso se vengono eseguite per tuo conto (ad esempio, componenti aggiuntivi che che hai installato ed eseguito). L'elenco di esecuzioni mostra solo la funzione iniziale chiamato per avviare l'esecuzione. Non mostra tutte le funzioni è stato chiamato durante l'esecuzione.

Puoi controllare quale tipo di esecuzione viene segnalato nel log utilizzando il metodo nella parte superiore della visualizzazione. Ogni riga del log rappresenta un singolo dell'esecuzione. Le colonne Ora di inizio, Durata e Stato mostrano le le informazioni corrispondenti all'esecuzione.

La colonna Funzione mostra il nome della funzione che ha avviato l'esecuzione. La colonna non contiene alcun nome se non hai accesso a progetto di script corrispondente dell'esecuzione, ma è stata eseguita 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 alla l'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 da un Stato: "In esecuzione". Per interrompere queste esecuzioni, a destra del progetto riga, fai clic su Altro > Termina.

Impostazioni

Puoi modificare le impostazioni della dashboard selezionando Impostazioni nella menu di navigazione a sinistra.

Nel riquadro Impostazioni è possibile attivare/disattivare l'API Apps Script. Questo ti permette di concedere all'API l'accesso ai tuoi progetti di script.

Per accedere a questa opzione, fai clic sull'API Google Apps Script nel riquadro Impostazioni. Si apre un nuovo riquadro con il testo di avviso un interruttore. L'accesso ai progetti di script è disattivato per impostazione predefinita come misura precauzionale. Una volta concesso l'accesso, qualsiasi applicazione di terze parti che autorizzi possono utilizzare l'API per modificare i tuoi script e deployment. Puoi revocare l'accesso nel riquadro Impostazioni in qualsiasi momento.

Puoi trovare ulteriori informazioni nel Guida all'accesso all'API Apps Script.