Apps Script fornisce alcune funzionalità che aiutano te e altri sviluppatori a creare e gestire insieme script, componenti aggiuntivi e app web.
Nozioni di base sulla collaborazione
Per collaborare a un progetto, tu e i tuoi collaboratori dovete disporre di accesso in qualità di editor al file del progetto Apps Script (e al relativo contenitore, se si tratta di uno script vincolato). In questo modo, tutti i membri del team possono visualizzare e apportare modifiche al codice di Apps Script. Gli editor possono anche creare nuove versioni di codice, pubblicare componenti aggiuntivi ed eseguire il deployment di script come app web o come eseguibili per l'API Apps Script.
Puoi aiutare il tuo team pianificando in anticipo come gestire l'editing, la revisione, la gestione 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ù facili con 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 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. Ciò potrebbe impedirti di gestire o aggiornare il progetto. Se inserisci il progetto di script in un Drive condiviso, questo problema viene evitato, poiché i file in un Drive condiviso non hanno proprietari specifici.
Collaborare con lo strumento a riga di comando clasp
clasp ti 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 come git.
Per maggiori dettagli, consulta la guida all'interfaccia a riga di comando per l'utilizzo di clasp.
Collaborare con i Drive condivisi
I Drive condivisi (in precedenza "Drive di gruppo") forniscono uno spazio condiviso in un Google Drive in cui 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 acquisisce 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 quel dominio nel Drive condiviso. Questo può essere molto utile 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 i Drive condivisi per collaborare a progetti di Apps Script, tieni presente quanto segue:
- I collaboratori con accesso in modifica a un Drive condiviso possono creare o spostare nuovi file nel Drive condiviso. In qualità di editor di script, possono visualizzare e modificare progetti di script, eseguire codice di script, creare nuove versioni di 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 della unità condivisa in cui risiede lo script.
- I Drive condivisi ti consentono di condividere file specifici all'interno del Drive condiviso con altre persone esterne al gruppo e di aggiornare le 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 ridurre il suo accesso per file specifici. Ad esempio, se un utente dispone dell'accesso in modifica a un Drive condiviso, non puoi impostare l'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 i file al di fuori del Drive condiviso.
- Tutti gli script legati al contenitore utilizzano gli stessi elenchi di accesso di visualizzatori ed editor definiti per il file contenitore. 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 inserisci un file contenitore 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 suo progetto Cloud (Google Cloud) potrebbe essere limitato. Per maggiori dettagli, consulta la sezione della guida relativa ai progetti Google Cloud e ai Drive condivisi.
- Le app web messe in produzione in un dominio non funzionano più se la loro proprietà viene trasferita a un account o a un drive condiviso in un dominio diverso. Questo problema può essere corretto spostando lo script nel dominio originale.
- Analogamente, i progetti di script che vengono implementati come eseguibili dell'API Apps Script cessano di funzionare quando vengono chiamati dall'API se vengono spostati tramite Drive condiviso da un dominio all'altro. Questo problema può essere corretto spostando lo script nel suo dominio originale.
Collaborare con una cartella condivisa
Se non riesci a collaborare con un Drive condiviso, puoi utilizzare una cartella condivisa. Quando crei o sposti un progetto di Apps Script in una cartella di Google Drive a cui altre persone possono accedere, queste ereditano lo stesso accesso al progetto di Apps Script che hanno per la cartella. Ad esempio:
- Se un utente dispone dell'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.
Collaborare 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 in cartelle di Google Drive normali o in Drive condivisi. Se utilizzi questo metodo, ti consigliamo di pianificare attentamente chi possiede e gestisce lo script nel tempo.
I progetti autonomi vengono visualizzati su Google Drive come file e puoi condividerli come qualsiasi altro file. Per ulteriori informazioni, consulta la sezione Condividere file e cartelle.
I progetti legati ai container non sono visibili su Google 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, puoi assegnare a un utente il ruolo di editor dello script assegnandogli il ruolo di editor del foglio di lavoro. I progetti legati ai container ereditano le impostazioni di accesso di visualizzatori ed editor del file del container.
Tutti gli script associati al contenitore utilizzano lo stesso elenco di accesso di proprietario, visualizzatore e editor definito per il file contenitore. Il proprietario del contenitore assume la proprietà di un nuovo progetto di script indipendentemente da chi lo ha creato.
Risorse di collaborazione e progetto
Le risorse sono entità associate al tuo progetto, ma esistono indipendentemente dal codice. Questa sezione spiega in che modo la collaborazione a un progetto influisce sulle relative risorse, in particolare sul progetto Cloud, sugli attivatori, sulle librerie e sulle proprietà utente.
Progetti di collaborazione e Google Cloud
Ogni progetto Apps Script ha un progetto Google Cloud associato. I progetti Google Cloud hanno un proprio insieme di proprietari, editor e altri ruoli, che può essere diverso dall'insieme di utenti che possono accedere al progetto dello script.
Se il progetto dello 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 Google Cloud per assicurarti che tutti i tuoi collaboratori dispongano dei livelli di accesso appropriati. In questo modo, eviterai 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, gli eventuali attivatori installabili che crei non vengono condivisi con gli utenti che hanno accesso al progetto. Se devi avere una configurazione degli attivatori coerente per tutti i collaboratori, puoi utilizzare il servizio Script per creare attivatori in modo programmatico, in fase di esecuzione. Per saperne di più, consulta Gestire gli attivatori in modo programmatico.
Collaborazione e librerie
Le librerie incluse nel progetto sono disponibili per i collaboratori del progetto. Tuttavia, se non hanno almeno accesso a livello di lettura a una libreria inclusa, non possono utilizzarle. In questo caso, lo script genera un errore. Per saperne di più sulle librerie, consulta Gestire le 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 proprietà script se vuoi condividere proprietà specifiche del progetto con i collaboratori. Per maggiori informazioni, consulta la guida sulle proprietà.