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 di esempi Gestione progetto mostra esempi di richieste di gestione delle API. La documentazione di riferimento per ciascun metodo fornisce i dettagli di implementazione.

Panoramica del metodo API
Creare progetti	projects.create Risultati: crea un progetto vuoto di base senza file di progetto e un manifest del progetto predefinito. Opzioni: puoi fornire un titolo per il progetto. Puoi anche creare uno script associato fornendo l'ID Google Drive di un file di Documenti, Fogli, Moduli Google o Presentazioni Google, in modo che agisca da file principale dello script.
Leggere 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, la creazione dell'utente, l'ora di creazione e altri dettagli.
Leggere 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 sotto forma di file JSON. Gli oggetti file includono 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 ricerca.
Aggiornare i contenuti del progetto	projects.updateContent Risultati: modifica i contenuti del file in un progetto di script. I nuovi contenuti vengono forniti sotto forma di 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 archiviati come versione HEAD del progetto. Viene utilizzato quando lo script viene eseguito come trigger, nell'editor di script, in modalità di anteprima dei componenti aggiuntivi o come app web o API Apps Script in modalità di sviluppo. Nota: quando aggiorni il contenuto del progetto di script, la pratica comune consiste innanzitutto nell'inviare una richiesta projects.getContent per recuperare un array di File esistenti, desiderare di utilizzare questi oggetti, quindi utilizzare i 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.
Leggere le metriche del progetto	projects.getMetrics Risultati: leggi alcune 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 MetricType per specificare le informazioni richieste. Opzioni: limita i risultati a deployment o funzioni di script specifici utilizzando un MetricFilter. Puoi anche definire un intervallo di metrica specifico utilizzando un MetricsIntervalConfig.