L'implementazione di un progetto Apps Script è una versione dello script resa disponibile per l'uso 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 deployment:
- Deployment head, che vengono sempre sincronizzati con il codice del progetto attuale.
- Deployment con versione con versione, collegati a una specifica versione del progetto.
Deployment head
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 dell'intestazione riflette queste modifiche, mentre il deployment con controllo delle versioni rimane invariato.
Usare i deployment head per testare il codice. Non utilizzare i deployment head per l'uso pubblico.
Deployment con controllo delle versioni
Un deployment sottoposto al 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 il consumo pubblico, utilizza sempre un deployment con controllo delle versioni. Puoi avere più deployment attivi del controllo delle versioni contemporaneamente.
Importante: non puoi trasferire la proprietà dei deployment con controllo delle versioni. Se trasferisci la proprietà di un progetto di script a un'altra persona, il proprietario dei deployment con versione esistente 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.
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 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 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, i componenti aggiuntivi Editor e le app Google Chat, seleziona Componente aggiuntivo.
Inserisci le informazioni sul deployment e fai clic su Esegui il deployment.
Visualizza i deployment con controllo delle versioni
Per visualizzare i deployment di un progetto Apps Script, in alto, fai clic su Esegui il deployment > Gestisci deployment.
Per visualizzare il codice di una versione specifica, consulta Visualizzare una versione precedente.
Modifica un deployment sottoposto al controllo delle versioni
Puoi modificare un deployment con controllo delle versioni per cambiarne la descrizione o la versione. Per modificare un deployment, segui questi passaggi:
- Apri il progetto Apps Script.
- Fai clic su Esegui il deployment > Gestisci deployment.
- Seleziona il deployment attivo da modificare e fai clic su Modifica .
Apporta le modifiche e fai clic su Esegui il deployment.
Se vuoi modificare un deployment archiviato, devi rieseguire il deployment e poi 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 usata automaticamente da tutti gli utenti che usano il deployment.
Trova un ID deployment
A ogni deployment viene creato automaticamente un ID stringa associato. 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 sui 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 il deployment di un componente aggiuntivo di Google Workspace, consulta Test dei componenti aggiuntivi di Google Workspace.
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 il deployment di un'app di Chat, devi prima creare un deployment con 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 poter 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 i deployment.
- Accanto a "Seleziona tipo", fai clic su Abilita tipi di deployment
> API Executable.
- Copia e utilizza l'URL per testare il deployment eseguibile dell'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 controllo delle versioni:
- 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 rieseguire il deployment e fai clic su Modifica > Esegui il deployment.