Gestione dei progetti

Questa sezione fornisce una panoramica dei metodi dell'API Apps Script che puoi utilizzare per creare, leggere, modificare e monitorare i tuoi progetti Apps Script. La pagina degli esempi di Project Management mostra esempi di richieste di gestione delle API. La documentazione di riferimento per ogni metodo fornisce i dettagli di implementazione.

Panoramica dei metodi API
Creare progetti

projects.create

Risultati: crea un progetto di base vuoto senza file di progetto e un manifest del progetto predefinito.

Opzioni: puoi fornire un titolo per il progetto. Puoi anche creare uno script vincolato fornendo l'ID di Google Drive di un file di Documenti, Fogli, Moduli o Presentazioni Google che fungerà da file principale dello script.

Leggi i metadati del progetto

projects.get

Risultati: recupera un oggetto Project che rappresenta i metadati del progetto. Questi dati includono il titolo del progetto, l'ID script, l'utente che lo ha creato, l'ora di creazione e altri dettagli.

Leggi i contenuti del progetto

projects.getContent

Risultati: restituisce un array di oggetti File, uno per ogni codice e file HTML del progetto. L'elenco include anche il manifest del progetto come file JSON. Gli oggetti File contengono i contenuti di origine del file (File.source) e altri metadati, ad esempio un elenco di funzioni nel file (File.functionSet).

Opzioni: puoi specificare la versione dei contenuti da recuperare con un parametro di query.

Aggiornare i contenuti del progetto

projects.updateContent

Risultati: modifica i contenuti del file in un progetto di script. Fornisci i nuovi contenuti come array di oggetti File. Uno di questi oggetti File deve avere il tipo JSON e rappresentare il nuovo manifest del progetto del progetto di script. I nuovi contenuti vengono memorizzati come versione HEAD del progetto. Viene utilizzato quando lo script viene eseguito come attivatore, nell'editor di script, in modalità di anteprima del componente aggiuntivo o come app web o API Apps Script in modalità di sviluppo.

Nota: quando aggiorni i contenuti di un progetto di script, è buona prassi innanzitutto emettere una richiesta projects.getContent per recuperare un array degli File esistenti, apportare le modifiche necessarie a questi oggetti e poi utilizzare gli File come input per una richiesta projects.updateContent.

Avviso: i nuovi contenuti sostituiscono tutti i file esistenti nel progetto di script. I file non aggiornati dalla richiesta vengono rimossi.

Leggi le metriche del progetto

projects.getMetrics

Risultati: leggi determinate metriche relative a un progetto. Queste metriche includono il numero di utenti, il numero totale di esecuzioni, il numero totale di errori di esecuzione e altri dettagli. Utilizza un valore MetricType per specificare le informazioni richieste.

Opzioni: limita i risultati a implementazioni o funzioni di script specifiche utilizzando un MetricsFilter. Puoi anche definire un intervallo di metriche specifico utilizzando un MetricsIntervalConfig.