Apps Script fornisce alcune funzionalità che aiutano te e gli altri sviluppatori a creare e gestire contemporaneamente script, componenti aggiuntivi e app web.
Nozioni di base sulla collaborazione
Per collaborare a un progetto, tu e i tuoi collaboratori dovete disporre tutti dell'accesso in modifica al file del progetto Apps Script (e al relativo contenitore, se è uno script associato). In questo modo tutti i membri del tuo team possono vedere e modificare il codice di Apps Script. Gli editor possono anche creare nuove versioni del codice, pubblicare componenti aggiuntivi e implementare script come app web o come eseguibili per l'API Apps Script.
Puoi aiutare il tuo team pianificando in anticipo la modalità di gestione della modifica, della revisione, del controllo delle versioni e, se applicabile, del deployment e della pubblicazione del progetto, del componente aggiuntivo o dell'app web. I progetti autonomi sono in genere i più semplici su cui collaborare, perché vengono visualizzati direttamente su Google Drive e rappresentano il tipo di progetto consigliato per lo sviluppo di app web e componenti aggiuntivi.
Un problema comune di 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. Di conseguenza, non puoi gestire o aggiornare il progetto. Collocando il tuo progetto di script in un Drive condiviso si evita questo problema, poiché i file su un Drive condiviso non hanno proprietari specifici.
Collabora con lo strumento a riga di comando clasp
clasp consente di sincronizzare i progetti tra script.google.com e il tuo 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 ulteriori dettagli, consulta la guida all'interfaccia a riga di comando
con clasp.
Collaborare con i Drive condivisi
I Drive condivisi (precedentemente noti come "Drive del team") forniscono uno spazio condiviso su Google Drive in cui gruppi di utenti di Drive possono collaborare in modo più efficace. I file che si trovano su 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 assume con sé la proprietà e il controllo dei file.
I Drive condivisi consentono inoltre di spostare file tra domini. Un Drive condiviso di un dominio può avere collaboratori di un altro dominio che possono spostare i file da quel dominio al Drive condiviso. Ciò può essere molto utile per gli sviluppatori di Apps Script, in quanto fornisce un mezzo per sviluppare componenti aggiuntivi, app web o altri codici per i clienti di domini diversi.
Quando utilizzi i Drive condivisi per collaborare a progetti Apps Script, tieni presente quanto segue:
- I collaboratori con accesso in modifica a un Drive condiviso possono creare o spostare nuovi file al suo interno. In qualità di editor di script, possono visualizzare e modificare progetti di script, eseguire codice di script, creare nuove versioni degli script e pubblicare componenti aggiuntivi.
- Per eseguire il deployment di 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 persone esterne al gruppo e di aggiornarne le autorizzazioni di modifica e visualizzazione per questi file come per 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 cambiare l'impostazione 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, nonché spostare file fuori dal Drive condiviso.
- Tutti gli script legati al container utilizzano gli stessi elenchi di accesso di visualizzatori ed editor definiti per il file del container. Ad esempio, se disponi dell'accesso in modifica a un foglio Google, hai anche accesso in modifica a qualsiasi codice di progetto Apps Script associato. Se posizioni un file di questo tipo in un Drive condiviso, i collaboratori del Drive condiviso avranno lo stesso accesso al codice dello script che hanno per il container stesso.
- Quando un progetto di script si trova su un Drive condiviso, l'accesso al relativo progetto della piattaforma Cloud (GCP) potrebbe essere limitato. Per maggiori dettagli, consulta la sezione della guida Progetti GCP e Drive condivisi.
- Le app web distribuite in un dominio cessano di funzionare se la loro proprietà passa a un Drive condiviso o a un account di un altro dominio. Per correggere questo problema, devi spostare nuovamente lo script nel dominio originale.
- Allo stesso modo, i progetti di script distribuiti come eseguibili dell'API Apps Script smettono di funzionare quando vengono chiamati dall'API se vengono spostati tramite un Drive condiviso da un dominio a un altro. Per risolvere il problema, sposta nuovamente lo script al dominio originale.
Collaborare con una cartella condivisa
Se non puoi collaborare con un Drive condiviso, puoi utilizzare una cartella condivisa. Quando crei o sposti un progetto Apps Script in una cartella di Google Drive a cui possono accedere altre persone, queste ultime ereditano lo stesso accesso al progetto Apps Script di cui dispongono per la cartella. Ad esempio:
- Se qualcuno 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.
Collabora con la condivisione di progetti
Puoi collaborare a un progetto condividendolo direttamente con tutti i collaboratori. Puoi condividere direttamente i progetti di script che si trovano nelle normali cartelle di Google Drive o nei Drive condivisi. Se utilizzi questo metodo, ti consigliamo di pianificare con attenzione chi è il proprietario e chi gestisce lo script nel corso del tempo.
I progetti autonomi vengono visualizzati in Google Drive sotto forma di file e puoi condividerli come qualsiasi altro file. Per ulteriori informazioni, vedi Condivisione di file e cartelle.
I progetti associati a un container non sono visibili su Google Drive. Per condividere un progetto legato al container, condividi il file del contenitore principale. Ad esempio, se hai uno script associato a un foglio di lavoro di Fogli Google, puoi rendere qualcuno un editor dello script rendendolo un editor del foglio di lavoro. I progetti legati al container ereditano le impostazioni di accesso in visualizzazione e in modifica al proprio file container.
Tutti gli script legati al container utilizzano lo stesso elenco di accesso come proprietario, visualizzatore ed editor definito per il file contenitore. Il proprietario del container assume la proprietà di un nuovo progetto di script indipendentemente da chi lo ha creato.
Risorse di collaborazione e progetti
Le risorse sono entità associate al progetto, ma esistenti in modo indipendente dal codice. Questa sezione spiega in che modo la collaborazione su un progetto influisce sulle sue risorse, in particolare sul progetto Cloud Platform, sui trigger, sulle librerie e sulle proprietà utente.
Collaborazione e progetti Google Cloud
A ogni progetto Apps Script è associato un progetto Google Cloud. I progetti Google Cloud hanno un proprio insieme di proprietari, editor e altri ruoli, che possono essere diversi dall'insieme di utenti che possono accedere al progetto di script.
Se il progetto di script deve essere pubblicato come componente aggiuntivo, deve utilizzare un progetto Google Cloud standard. Quando collabori a un'applicazione che utilizza un progetto Google Cloud standard, ti consigliamo di configurare i proprietari e i ruoli di Google Cloud per assicurarti che tutti i tuoi collaboratori dispongano dei livelli di accesso appropriati. In questo modo è possibile evitare situazioni in cui perdi l'accesso alle impostazioni Cloud del progetto perché i relativi proprietari non fanno più parte della tua organizzazione. Questo è particolarmente importante per i componenti aggiuntivi.
Collaborazione e trigger
Quando collabori a un progetto, tutti i trigger installabili che crei non vengono condivisi con gli utenti che hanno accesso al progetto. Se devi disporre di una configurazione coerente del trigger per tutti i collaboratori, puoi utilizzare il servizio Script per creare i trigger in modo programmatico, in fase di esecuzione. Per maggiori informazioni, consulta Gestire i trigger in modo programmatico.
Collaborazione e librerie
Le librerie incluse nel progetto sono disponibili per i collaboratori del progetto. Tuttavia, se gli utenti non hanno almeno l'accesso a livello di lettura a una libreria inclusa, non possono usarle, in questo caso lo script genera un errore. Per ulteriori informazioni sulle librerie, consulta la sezione 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 visualizzare o accedere alle tue proprietà utente e tu non puoi visualizzare o accedere alle loro. Utilizza le proprietà script se vuoi condividere proprietà specifiche del progetto con i collaboratori. Per ulteriori informazioni, consulta la guida alle proprietà.