Il deployment di un progetto Google Apps Script è una versione dello script che è disponibile per l'utilizzo come app web, componente aggiuntivo di Google Workspace o eseguibile API. Creando e gestendo i deployment, puoi iterare il codice, tenere traccia delle modifiche e controllare la versione del codice a cui accedono gli utenti.
Esistono due tipi di implementazioni:
- Deployment head, che vengono sempre sincronizzati con il codice del progetto corrente.
- Deployment con controllo delle versioni, che si connettono a una versione specifica del progetto.
Deployment principali
Un deployment head è il codice del progetto attuale. Quando crei un progetto Apps Script, il sistema crea automaticamente un deployment head per il progetto.
Il deployment head si sincronizza sempre 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.
Esiste un solo deployment principale per ogni progetto Apps Script. Per utilizzare un deployment head, devi disporre almeno dell'accesso in lettura al progetto di script.
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 pubblichi un'applicazione per uso pubblico, utilizza sempre un deployment 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, il proprietario delle implementazioni con controllo delle versioni esistenti non cambia. Se un amministratore elimina l'account del proprietario del deployment, i deployment potrebbero riscontrare errori di script.
Crea un deployment con controllo delle versioni
Per eseguire il deployment di una versione di un componente aggiuntivo, di un componente aggiuntivo per editor, di un'app 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. <<../_common/snippets/create-new-deployment.md>>
Ogni nuovo deployment può essere condiviso come libreria. Se condividi lo script come libreria, la descrizione del deployment è visibile agli utenti della libreria.
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 e fai clic su Modifica .
- Apporta le modifiche e fai clic su Esegui il deployment.
Per modificare un deployment archiviato, esegui nuovamente il deployment e poi segui i passaggi precedenti.
Per eseguire il deployment di una modifica al codice del progetto, crea una nuova versione e modifica il deployment in modo che la utilizzi. Il deployment utilizza automaticamente la nuova versione per tutti gli utenti.
Trovare un ID deployment
Ogni deployment ha un ID stringa associato. 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 nei deployment attivi.
Testare un deployment
Il metodo per testare un deployment dipende dal tipo di app che crei.
Componente aggiuntivo di Google Workspace
Per testare il deployment di un componente aggiuntivo, consulta Testare i componenti aggiuntivi.
Componente aggiuntivo Editor
Per testare il deployment di un componente aggiuntivo Editor, vedi 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 un deployment dell'app di chat, crea un deployment con controllo delle versioni dello script per accedere al relativo ID deployment.
Dopo aver ottenuto l'ID deployment, specificarlo nella configurazione dell'API Chat e segui i passaggi per testare le funzionalità interattive.
Eseguibile API
Per testare un deployment eseguibile dell'API, crea 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 > Test dei deployment.
- Accanto a "Seleziona tipo", fai clic su
> API eseguibile. - 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. Puoi invece archiviarli.
Per archiviare un deployment con versioni:
- Apri il progetto Apps Script.
- Fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona il deployment 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.
- In Archiviati, seleziona l'implementazione e fai clic su Modifica > Implementa.