Il deployment di un progetto Apps Script è una versione dello script che viene messa a disposizione per l'utilizzo come app web, componente aggiuntivo o eseguibile API. Creando e gestendo i deployment, puoi eseguire l'iterazione del codice, tenere traccia delle modifiche e controllare la versione esatta del codice a cui hanno accesso gli utenti.
Esistono due tipi di implementazioni:
- Deployment principali, che vengono sempre sincronizzati con il codice del progetto corrente.
- Deployment con versione, collegati a una versione del progetto specifica.
Deployment principali
Un deployment head è il codice del progetto corrente. Quando crei un progetto Apps Script, crei automaticamente un deployment principale per quel progetto.
Il deployment principale è sempre sincronizzato con il codice salvato più di recente. Ad esempio, se crei un deployment con versione e poi modifichi il codice, il deployment principale riflette queste modifiche, mentre il deployment con versione rimane invariato.
Utilizza i deployment principali per testare il codice. Non utilizzare i deployment principali 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 l'applicazione viene pubblicata per uso pubblico, utilizza sempre un deployment con versione. Puoi avere più implementazioni con versioni attive contemporaneamente.
Importante: non puoi trasferire la proprietà dei deployment con versione. Se trasferisci la proprietà di un progetto di script a un'altra persona, 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.
Creare un deployment con versionamento
Per eseguire il deployment di una versione di un componente aggiuntivo di Google Workspace, un componente aggiuntivo di Editor, un'app Google Chat o un file eseguibile dell'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 versione:
- 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 di Google Chat, seleziona Componente aggiuntivo.
Inserisci le informazioni sul deployment e fai clic su Esegui il deployment.
Visualizza i deployment con versione
Per visualizzare le implementazioni di un progetto Apps Script, in alto, fai clic su Esegui il deployment > Gestisci implementazioni.
Per visualizzare il codice di una versione specifica, consulta Visualizzare una versione precedente.
Modificare un deployment con versione
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 eseguirlo di nuovo, quindi seguire 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 utilizzano il deployment.
Trovare un ID deployment
A ogni implementazione viene associato automaticamente un ID stringa. Per trovare questo ID, segui i passaggi che seguono:
- Apri il progetto Apps Script.
- In alto a destra, fai clic su Esegui il deployment > Gestisci i deployment.
Seleziona un deployment attivo per trovare il relativo ID.
Gli ID di deployment vengono visualizzati solo nei deployment attivi.
Testare 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, consulta Testare i componenti aggiuntivi di Google Workspace.
Componente aggiuntivo Editor
Per testare il deployment di un componente aggiuntivo di Editor, consulta Testare un componente aggiuntivo di 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 versione dello script per accedere al relativo ID deployment.
Dopo aver ottenuto l'ID di implementazione, specificalo nella configurazione dell'API Chat e segui i passaggi per testare le funzionalità interattive.
Eseguibile API
Per testare un deployment dell'eseguibile dell'API, devi prima creare un deployment con versione. Dopo aver creato un deployment, segui i passaggi riportati di seguito:
- In alto a destra nel progetto di Apps Script, fai clic su Esegui il deployment > Testa i deployment.
- Accanto a "Seleziona tipo", fai clic su Attiva i tipi di deployment
> Eseguibile API.
- Copia e utilizza l'URL per testare il deployment dell'eseguibile API.
Archiviare un deployment con versione
Non puoi eliminare i deployment con versione. In alternativa, puoi archiviarli.
Per archiviare un deployment con versione:
- 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 i deployment.
- A sinistra, in Archiviati, seleziona il deployment di cui vuoi eseguire nuovamente il deployment e fai clic su Modifica > Esegui il deployment.