Apps Script offre alcune funzionalità che consentono a te e ad altri sviluppatori di 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 di progetto Apps Script (e al relativo container, se si tratta di uno script vincolato). In questo modo tutti i membri del team possono vedere e modificare il codice di Apps Script. Gli editor possono inoltre creare nuove versioni di 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 come gestire modifiche, revisione, controllo delle versioni e, se applicabile, il deployment e la 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 in Google Drive e sono il tipo di progetto consigliato per lo sviluppo di componenti aggiuntivi e app web.
Un problema comune durante la collaborazione si verifica quando il proprietario del progetto di script lascia il team senza trasferire la proprietà del progetto a un altro membro del team. Questo può impedirti di gestire o aggiornare il progetto. Il posizionamento del progetto di script in un Drive condiviso evita questo problema, poiché i file in 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 software di gestione del controllo del codice sorgente come git.
Per maggiori dettagli, consulta la sezione Interfaccia a riga di comando
utilizzando la guida di clasp.
Collaborare con i Drive condivisi
I Drive condivisi (precedentemente noti come "Drive del team") offrono uno spazio condiviso su un Google Drive in cui i gruppi di utenti di Drive possono collaborare in modo più efficace. I file archiviati in un Drive condiviso sono di proprietà dell'intero gruppo, non dei singoli utenti. Ciò significa che quando un collaboratore lascia il gruppo non assume la proprietà e il controllo dei file al suo interno.
I Drive condivisi ti consentono inoltre di spostare i file tra più 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. Questo può essere molto prezioso per gli sviluppatori di Apps Script, in quanto fornisce a un team un mezzo per sviluppare componenti aggiuntivi, app web o altro codice per i clienti in domini diversi.
Quando utilizzi 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 i 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 risiede lo script.
- I Drive condivisi ti consentono di condividere file specifici all'interno del Drive condiviso con persone esterne al gruppo e di aggiornare le relative autorizzazioni di modifica e visualizzazione su 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 ridurne l'accesso per file specifici. Ad esempio, se un utente ha accesso in modifica a un Drive condiviso, non puoi cambiarlo in modo che abbia accesso di sola visualizzazione a 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 spostarli fuori dal Drive condiviso.
- Tutti gli script associati al container utilizzano gli stessi elenchi di accesso di visualizzazione ed editor definiti per il file contenitore. Ad esempio, se disponi dell'accesso in modifica a un foglio Google, disponi anche dell'accesso in modifica a qualsiasi codice del progetto Apps Script associato. Il posizionamento di un file contenitore in un Drive condiviso concede ai collaboratori del Drive condiviso lo stesso accesso al codice dello script che hanno per il contenitore stesso.
- Quando un progetto di script si trova su un Drive condiviso, l'accesso al relativo progetto Cloud Platform (Google Cloud) potrebbe essere limitato. Per maggiori dettagli, consulta la sezione della guida relativa ai progetti e ai Drive condivisi Google Cloud.
- Le app web distribuite in un dominio cessano di funzionare se la loro proprietà passa a un Drive condiviso o a un account in un dominio diverso. Questo problema può essere risolto ripristinando il dominio originale dello script.
- 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, puoi ripristinare il dominio originale dello script.
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 altre persone possono accedere, queste ereditano lo stesso accesso al progetto Apps Script che hanno 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 un utente ha solo accesso in visualizzazione alla cartella, può visualizzare il progetto Apps Script ed eseguire lo script.
Collabora con la condivisione dei 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 possiede e gestisce lo script nel tempo.
I progetti autonomi vengono visualizzati in Google Drive come file e puoi condividerli come qualsiasi altro file. Per ulteriori informazioni, vedi Condivisione di file e cartelle.
I progetti associati al container non sono visibili da Google Drive. Per condividere un progetto associato a un container, condividi il file contenitore padre. Ad esempio, se hai uno script associato a un foglio di lavoro di Fogli Google, puoi impostare qualcuno come editor dello script rendendolo un editor del foglio di lavoro. I progetti associati a un container ereditano le impostazioni di accesso come visualizzatore e in modifica del file container.
Tutti gli script associati al contenitore utilizzano lo stesso elenco di accesso proprietario, visualizzatore ed editor definito per il file del contenitore. Il proprietario del container assume la proprietà 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 progetto, ma che esistono indipendentemente dal codice. Questa sezione spiega in che modo la collaborazione su un progetto influisce sulle sue risorse, in particolare: progetto, trigger, librerie e proprietà utente della piattaforma Cloud.
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 può essere diverso da quello di utenti che possono accedere al progetto di script.
Se il progetto di script è destinato a 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 garantire 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 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 hai bisogno di una configurazione dei trigger coerente per tutti i collaboratori, puoi utilizzare il servizio Script per creare i trigger in modo programmatico, in fase di esecuzione. Per ulteriori informazioni, consulta Gestione dei trigger in modo programmatico.
Collaborazione e librerie
Le librerie incluse nel progetto sono disponibili per i collaboratori del progetto. Tuttavia, se non dispongono almeno dell'accesso di livello di lettura a una libreria inclusa, non possono utilizzare queste librerie: in questo caso lo script genera un errore. Per ulteriori informazioni sulle librerie, consulta 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 vedere o accedere alle loro. Utilizza le proprietà dello script se vuoi condividere le proprietà specifiche del progetto con i collaboratori. Per ulteriori informazioni, consulta la Guida alle proprietà.