La distribuzione di un progetto Apps Script è una versione dello script resa disponibile per l'utilizzo come applicazione web, componente aggiuntivo o API eseguibile. Creando e gestendo i deployment, puoi eseguire l'iterazione del codice, tenere traccia delle modifiche e controllare a quale versione esatta del codice hanno accesso gli utenti.
Esistono due tipi di deployment:
- Deployment principali, che sono sempre sincronizzati con il codice del progetto corrente.
- Deployment in versione, connessi a una versione specifica di un progetto.
Deployment head
Un deployment head è il codice del progetto corrente. Quando crei un progetto Apps Script, viene creato automaticamente un deployment head per quel progetto.
Il deployment head è sempre sincronizzato con il codice salvato più di recente. Ad esempio, se crei un deployment con controllo delle versioni e poi modifichi il codice, il deployment head riflette queste modifiche, mentre il deployment con controllo delle versioni rimane intatto.
Usa i deployment head per testare il codice. Non utilizzare i deployment head per uso pubblico.
Deployment con più versioni
Un deployment con il controllo delle versioni rende disponibile una versione specifica del codice del progetto. Ciò consente agli utenti di continuare a utilizzare una versione funzionante mentre apporti modifiche e miglioramenti al codice.
Quando l'applicazione viene pubblicata per il pubblico, usa sempre un deployment con versione. Puoi avere più deployment attivi del controllo delle versioni contemporaneamente.
Importante: non puoi trasferire la proprietà dei deployment sottoposti a controllo delle versioni. Se trasferisci la proprietà di un progetto di script a un altro utente, il proprietario dei deployment con versione esistenti all'interno del progetto non cambia. Se un amministratore elimina l'account del proprietario del deployment, potresti riscontrare errori di script per i relativi deployment.
Creazione di un deployment con controllo delle versioni
Per eseguire il deployment di una versione di un componente aggiuntivo di Google Workspace, di un componente aggiuntivo di Editor, di un'app Google Chat o di un'API eseguibile, devi prima cambiare l'associazione del progetto Google Cloud di Apps Script dal progetto predefinito a un progetto standard.
Per creare un deployment con il controllo delle versioni, segui questi passaggi:
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Nuovo deployment.
- Accanto a Seleziona tipo, fai clic su Abilita tipi di deployment .
- Seleziona il tipo di deployment di cui vuoi eseguire il deployment. Per i componenti aggiuntivi di Google Workspace, gli editor e le app Google Chat, seleziona Componente aggiuntivo.
Inserisci le informazioni sul deployment e fai clic su Esegui il deployment.
Visualizza deployment con controllo delle versioni
Per visualizzare i deployment di un progetto Apps Script, fai clic su Esegui il deployment > Gestisci deployment in alto.
Per visualizzare il codice di una versione specifica, consulta Visualizzare una versione precedente.
Modifica un deployment con controllo delle versioni
Puoi modificare un deployment con versione per cambiarne la descrizione o la versione. Per modificare un deployment:
- Apri il progetto Apps Script.
- Fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona il deployment attivo che vuoi modificare e fai clic su Modifica .
Apporta le modifiche e fai clic su Esegui il deployment.
Se vuoi modificare un deployment archiviato, devi eseguirne nuovamente il deployment, quindi segui i passaggi precedenti.
Quando vuoi eseguire il deployment di una modifica al codice del progetto, crea una nuova versione e modifica il deployment per utilizzarla. La nuova versione viene utilizzata automaticamente da tutti gli utenti che usano il deployment.
Trovare un ID deployment
A ogni deployment è associato un ID stringa creato automaticamente. Per trovare questo ID:
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Gestisci deployment.
Seleziona un deployment attivo per trovare il relativo ID.
Gli ID deployment vengono visualizzati solo sui deployment attivi.
Testa un deployment
La modalità di test di un deployment dipende dal tipo di app che crei.
Componente aggiuntivo di Google Workspace
Per testare il deployment di un componente aggiuntivo di Google Workspace, vedi Testare i componenti aggiuntivi di Google Workspace.
Componente aggiuntivo Editor
Per testare il deployment di un componente aggiuntivo dell'editor, vedi Testare un componente aggiuntivo dell'editor.
App web
Per testare il deployment di un'app web, vedi Testare il deployment di un'app web.
App Google Chat
Per testare il deployment di un'app di Chat, devi prima creare un deployment con il controllo delle versioni dello script per accedere al relativo ID deployment.
Una volta ottenuto l'ID deployment, segui i passaggi per abilitare l'API Google Chat. Nella sezione "Autorizzazioni" della pagina Configurazione, specifica solo il tuo indirizzo email per installare e testare la tua app.
Eseguibile API
Per testare un deployment eseguibile dell'API, devi prima creare un deployment con controllo delle versioni. Dopo aver creato un deployment, segui questi passaggi:
- In alto a destra nel progetto Apps Script, fai clic su Esegui il deployment > Testa deployment.
- Accanto a "Seleziona tipo", fai clic su Abilita tipi di deployment
> Eseguibile API.
- Copia e utilizza l'URL per testare il deployment dell'API eseguibile.
Archiviare un deployment con controllo delle versioni
Non puoi eliminare i deployment sottoposti al controllo delle versioni. Puoi però archiviarli.
Per archiviare un deployment con versione:
- Apri il progetto Apps Script.
- Fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona il deployment da archiviare e fai clic su Archivia deployment .
Esegui di nuovo il deployment di un deployment archiviato
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Gestisci deployment.
- A sinistra, in Archiviato, seleziona il deployment di cui vuoi eseguire nuovamente il deployment e fai clic su Modifica > Esegui il deployment.