Google Apps Script offre funzionalità che aiutano i team a creare e gestire insieme script, componenti aggiuntivi di Google Workspace e app web. Questa guida tratta la collaborazione attiva a un progetto da parte di più sviluppatori. Se vuoi condividere il codice da includere nei progetti di altri, consulta la guida Librerie.
Nozioni di base sulla collaborazione
Per collaborare a un progetto, tu e i tuoi collaboratori dovete disporre dell'accesso in modifica al file di progetto Apps Script (e al relativo contenitore, se si tratta di uno script associato). In questo modo, tutti i membri del tuo team possono visualizzare e apportare modifiche al codice Apps Script. Gli editor possono anche creare nuove versioni del codice, pubblicare componenti aggiuntivi e implementare gli script come app web o come eseguibili per l'API Apps Script.
Pianifica in anticipo la gestione della modifica, della revisione, del controllo delle versioni e (se applicabile) del deployment e della pubblicazione del tuo progetto, del tuo componente aggiuntivo o della tua web app. I progetti autonomi sono in genere i più semplici su cui collaborare, perché vengono visualizzati direttamente in Google Drive e sono il tipo di progetto consigliato per lo sviluppo di componenti aggiuntivi e web app.
Un problema comune nella collaborazione si verifica quando il proprietario di un progetto di script lascia il team senza trasferire la proprietà del progetto a un altro membro del team. In questo modo, non potrai mantenere o aggiornare il progetto. Se inserisci il progetto di script in un Drive condiviso, questo problema non si verifica, perché i file in un Drive condiviso non hanno proprietari specifici.
Condividi sempre la proprietà dei progetti di script. Se un utente lascia la tua organizzazione e il suo account viene rimosso, l'accesso agli script senza altri proprietari viene perso. Condividi il copione su Drive o spostalo in un Drive condiviso.
Collaborare con lo strumento a riga di comando clasp
clasp ti consente di sincronizzare i progetti tra script.google.com e il file system locale. In questo modo puoi semplificare
e automatizzare lo sviluppo del codice se tu e i tuoi collaboratori utilizzate
un software di gestione del controllo del codice sorgente come git.
Per maggiori dettagli, consulta la guida all'interfaccia a riga di comando
utilizzando clasp.
Collaborare con i Drive condivisi
I drive condivisi sono disponibili solo per i clienti di Google Workspace Business e Google Workspace Enterprise.
I Drive condivisi forniscono uno spazio condiviso in Drive in cui i gruppi di utenti di Drive possono collaborare in modo più efficace. I file inseriti in un Drive condiviso sono di proprietà del gruppo nel suo complesso, non dei singoli utenti. Ciò significa che quando un collaboratore lascia il gruppo, non porta con sé la proprietà e il controllo dei file.
I Drive condivisi ti consentono anche di spostare file tra domini: un Drive condiviso in un dominio può avere collaboratori di un altro dominio che possono spostare file da questo dominio nel Drive condiviso. In questo modo, un team può sviluppare componenti aggiuntivi, app web o altro codice per i clienti di domini diversi.
Quando utilizzi i Drive condivisi per collaborare ai progetti Apps Script:
- I collaboratori con accesso come editor a un Drive condiviso possono creare o spostare nuovi file nel Drive condiviso. In qualità di editor di script, possono visualizzare e modificare i progetti di script, eseguire il codice dello script, creare nuove versioni dello script e pubblicare componenti aggiuntivi.
- Per eseguire il deployment degli script come app web o eseguibili per l'API Apps Script, l'account che crea il deployment deve appartenere allo stesso dominio del drive condiviso in cui si trova lo script.
- I Drive condivisi ti consentono di condividere file specifici all'interno del Drive condiviso con altre persone al di fuori del gruppo e di aggiornare le autorizzazioni di modifica e visualizzazione di questi file come qualsiasi altro file di Drive. Tuttavia, se un utente fa parte del team a cui appartiene il Drive condiviso, non puoi ridurre il suo accesso a file specifici. Ad esempio, se un utente ha accesso in modifica a un Drive condiviso, non puoi modificarlo in accesso di sola visualizzazione per un file specifico all'interno del Drive condiviso.
- I collaboratori con accesso completo a un Drive condiviso possono anche eliminare file e progetti Apps Script e spostare i file fuori dal Drive condiviso.
- Tutti gli script associati al contenitore utilizzano gli stessi elenchi di accesso per visualizzatori ed editor definiti per il file contenitore. Ad esempio, se hai accesso in modifica a un Foglio Google, hai anche accesso in modifica a qualsiasi codice di progetto Apps Script allegato. Se inserisci un file contenitore di questo tipo in un Drive condiviso, i collaboratori del Drive condiviso avranno lo stesso accesso al codice dello script che hanno per il contenitore stesso.
- Quando un progetto di script si trova in un Drive condiviso, l'accesso al relativo progetto Google Cloud potrebbe essere limitato. Per i dettagli, consulta la sezione della guida Progetti Google Cloud e Drive condivisi.
- Le app web implementate in un dominio smettono di funzionare se la loro proprietà viene trasferita a un account o Drive condiviso in un dominio diverso. Correggi il problema spostando lo script di nuovo nel dominio originale.
- Allo stesso modo, i progetti di script implementati come eseguibile dell'API Apps Script cessano di funzionare quando vengono chiamati dall'API se vengono spostati tramite unità condivisa da un dominio a un altro. Correggi questo problema spostando lo script di nuovo nel suo dominio originale.
Collaborare con una cartella condivisa
Fai attenzione se crei o sposti un progetto Apps Script in una cartella condivisa. Assicurati che la cartella sia condivisa solo con persone di cui ti fidi.
Se non riesci a collaborare con un Drive condiviso, utilizza una cartella condivisa. Quando crei o sposti un progetto Apps Script in una cartella di Drive a cui possono accedere altre persone, queste ereditano lo stesso accesso al progetto Apps Script che hanno per la cartella. Ad esempio:
- Se un utente ha accesso in modifica alla cartella, può modificare o eliminare il progetto Apps Script ed eseguire lo script.
- Se qualcuno ha solo accesso in visualizzazione alla cartella, può visualizzare il progetto Apps Script ed eseguire lo script.
Collaborare con la condivisione dei progetti
Collaborare a un progetto condividendolo direttamente con tutti i collaboratori. Condividi direttamente i progetti di copione che si trovano nelle normali cartelle di Drive o nei Drive condivisi. Pianifica con attenzione chi possiede e gestisce lo script nel tempo.
I progetti autonomi vengono visualizzati in Drive come file; condividili come qualsiasi altro file. Per ulteriori informazioni, vedi Condividere file e cartelle.
I progetti associati a un contenitore non sono visibili in Drive. Per condividere un progetto associato a un contenitore, condividi il file contenitore principale. Ad esempio, se hai uno script associato a un foglio di lavoro Google Sheets, rendi un utente editor dello script rendendolo editor del foglio di lavoro. I progetti associati a un contenitore ereditano le impostazioni di accesso come visualizzatore ed editor del file contenitore.
Tutti gli script associati al container utilizzano lo stesso elenco di accesso di proprietari, visualizzatori ed editor definito per il file container. Il proprietario del contenitore diventa proprietario di un nuovo progetto di script, indipendentemente da chi lo ha creato.
Risorse per la collaborazione e i progetti
Le risorse sono entità associate al tuo progetto, ma esistono indipendentemente dal suo codice. Questa sezione spiega in che modo la collaborazione a un progetto influisce sulle sue risorse, in particolare: progetto Google Cloud, trigger, librerie e proprietà utente.
Collaborazione e progetti Google Cloud
Ogni progetto Apps Script ha un progetto Google Cloud associato. I progetti Google Cloud hanno il proprio insieme di proprietari, editor e altri ruoli, che possono essere diversi dall'insieme di utenti che possono accedere al progetto di script.
Collaborazione e trigger
Quando collabori a un progetto, tutti i trigger installabili che crei non vengono condivisi con chi ha accesso al tuo progetto. Se devi configurare un trigger coerente per tutti i collaboratori, utilizza il servizio Script per creare trigger in modo programmatico, in fase di runtime. Per saperne di più, consulta Gestione dei trigger a livello di programmazione.
collaboratori.
Collaborazione e librerie
Le librerie incluse nel tuo progetto sono disponibili per i collaboratori del progetto. Tuttavia, se non dispongono almeno dell'accesso a livello di lettura a una libreria inclusa, non possono utilizzare queste librerie e lo script genera un errore. Per saperne di più sulle librerie, vedi Gestione delle librerie.
Collaborazione e proprietà utente
Le proprietà utente sono univoche per l'utente che le ha create. Ciò significa che i collaboratori del progetto non possono vedere o accedere alle tue proprietà utente e tu non puoi vedere o accedere alle loro. Utilizza le proprietà dello script se vuoi condividere proprietà specifiche del progetto con i collaboratori. Per maggiori informazioni, consulta la Guida alle proprietà.