Il deployment di un progetto Apps Script è una versione dello script resa disponibile per l'utilizzo come app web, componente aggiuntivo o eseguibile API. Creando e gestendo le implementazioni, puoi iterare il codice, tenere traccia delle modifiche e controllare la versione esatta del codice a cui hanno accesso i tuoi utenti.
Esistono due tipi di implementazioni:
- Deployment head, che vengono sempre sincronizzati con il codice del progetto corrente.
- Deployment con controllo delle versioni, collegati a una versione specifica del progetto.
Deployment principali
Un deployment head è il codice del progetto attuale. Quando crei un progetto Apps Script, crei 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.
Utilizza i deployment head per testare il codice. Non utilizzare le implementazioni della testa per uso pubblico.
Deployment con controllo delle versioni
Un deployment con controllo delle versioni rende disponibile una versione specifica del codice del progetto. In questo modo, gli utenti possono continuare a utilizzare una versione funzionante mentre apporti modifiche e miglioramenti al codice.
Quando la tua applicazione viene pubblicata per l'utilizzo pubblico, utilizza sempre una distribuzione con controllo delle versioni. Puoi avere più deployment con controllo delle versioni attivi contemporaneamente.
Importante: non puoi trasferire la proprietà dei deployment con controllo delle versioni. Se trasferisci la proprietà di un progetto di script a un altro utente, il proprietario delle implementazioni con controllo delle versioni esistenti all'interno del progetto non cambia. Se un amministratore elimina l'account del proprietario del deployment, potresti riscontrare errori di script per i suoi deployment.
Crea un deployment con controllo delle versioni
Per eseguire il deployment di una versione di un componente aggiuntivo di Google Workspace, di un componente aggiuntivo dell'editor, di un'app Google Chat o di un eseguibile API, devi prima cambiare l'associazione del progetto Google Cloud di Apps Script dal progetto predefinito a un progetto standard.
Per creare un deployment con controllo delle versioni:
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Nuovo deployment.
- Accanto a Seleziona tipo, fai clic su Attiva tipi di deployment .
- Seleziona il tipo di deployment che vuoi eseguire. Per i componenti aggiuntivi di Google Workspace, i componenti aggiuntivi dell'editor e le app Google Chat, seleziona Componente aggiuntivo.
Inserisci le informazioni sul deployment e fai clic su Esegui il deployment.
Visualizzare i deployment con controllo delle versioni
Per visualizzare le implementazioni di un progetto Apps Script, in alto, fai clic su Implementa > Gestisci implementazioni.
Per visualizzare il codice di una versione specifica, consulta Visualizzare una versione precedente.
Modificare un deployment con controllo delle versioni
Puoi modificare un deployment con controllo delle versioni 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 l'implementazione attiva 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 in modo che la utilizzi. La nuova versione viene utilizzata automaticamente da tutti gli utenti che utilizzano questo deployment.
Trovare un ID deployment
A ogni deployment viene associato un ID stringa creato automaticamente. Per trovare questo ID, segui questi passaggi:
- 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 nei deployment attivi.
Testare un deployment
Il modo in cui testi un deployment dipende dal tipo di app che crei.
Componente aggiuntivo di Google Workspace
Per testare un deployment di componenti aggiuntivi di Google Workspace, consulta Testare i componenti aggiuntivi di Google Workspace.
Componente aggiuntivo Editor
Per testare il deployment di un componente aggiuntivo Editor, consulta Testare un componente aggiuntivo 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 Chat, devi prima creare un deployment con controllo delle versioni dello script per accedere al relativo ID deployment.
Dopo aver ottenuto l'ID deployment, specificalo nella configurazione dell'API Chat e segui i passaggi per testare le funzionalità interattive.
Eseguibile API
Per testare il deployment di un eseguibile API, devi prima creare un deployment con controllo delle versioni. Dopo aver creato un deployment, segui i passaggi riportati di seguito:
- In alto a destra nel progetto Apps Script, fai clic su Esegui il deployment > Test dei deployment.
- Accanto a "Seleziona tipo", fai clic su Attiva tipi di deployment
> Eseguibile API. - Copia e utilizza l'URL per testare il deployment dell'eseguibile API.
Archiviare un deployment con controllo delle versioni
Non puoi eliminare i deployment con controllo delle versioni. In alternativa, puoi archiviarli.
Per archiviare un deployment con versioni:
- Apri il progetto Apps Script.
- Fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona il deployment che vuoi archiviare e fai clic su Archivia deployment .
Eseguire nuovamente 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 Archiviati, seleziona il deployment che vuoi eseguire di nuovo e fai clic su Modifica > Esegui il deployment.