O Google Apps Script oferece recursos que ajudam as equipes a criar e manter scripts, complementos do Google Workspace e apps da Web em conjunto. Este guia aborda a colaboração ativa em um projeto por vários desenvolvedores. Se você quiser compartilhar código para que outras pessoas incluam nos próprios projetos, consulte o guia Bibliotecas.
Noções básicas de colaboração
Para colaborar em um projeto, você e seus colaboradores precisam ter acesso de editor ao arquivo do projeto do Apps Script e ao contêiner dele, se for um script vinculado. Assim, todos na sua equipe podem ver e fazer mudanças no código do Apps Script. Os editores também podem criar novas versões de código, publicar complementos e implantar scripts como apps da Web ou executáveis para a API Apps Script.
Planeje com antecedência como você vai lidar com a edição, revisão, controle de versões e (se aplicável) a implantação e publicação do seu projeto, complemento ou app da Web. Os projetos independentes geralmente são os mais fáceis de colaborar, porque aparecem diretamente no Google Drive e são o tipo de projeto recomendado para o desenvolvimento de complementos e apps da Web.
Um problema comum na colaboração ocorre quando o proprietário de um projeto de script sai da equipe sem transferir a propriedade do projeto para outra pessoa. Isso pode impedir que você mantenha ou atualize o projeto. Colocar o projeto de script em um drive compartilhado evita esse problema, já que os arquivos em um drive compartilhado não têm proprietários específicos.
Sempre compartilhe a propriedade dos projetos de script. Se alguém sair da organização e a conta dessa pessoa for removida, o acesso aos scripts sem outros proprietários será perdido. Compartilhe o script no Drive ou mova para um drive compartilhado.
Colaborar com a ferramenta de linha de comando clasp
O clasp permite sincronizar projetos entre script.google.com e seu sistema de arquivos local. Isso permite simplificar
e automatizar o desenvolvimento de código se você e seus colaboradores estiverem usando
um software de gerenciamento de controle de origem, como o git.
Para mais detalhes, consulte o guia da interface da linha de comando
usando clasp.
Colaborar com drives compartilhados
As unidades compartilhadas estão disponíveis apenas para clientes do Google Workspace Business e do Google Workspace Enterprise.
Os drives compartilhados oferecem um espaço compartilhado no Drive em que grupos de usuários podem colaborar de maneira mais eficiente. Os arquivos colocados em um drive compartilhado pertencem ao grupo como um todo, e não a pessoas específicas. Isso significa que, quando um colaborador sai do grupo, ele não leva a propriedade e o controle dos arquivos.
Os drives compartilhados também permitem mover arquivos entre domínios. Um drive compartilhado em um domínio pode ter colaboradores de outro domínio que podem mover arquivos desse domínio para o drive compartilhado. Isso oferece um meio para uma equipe desenvolver complementos, apps da Web ou outros códigos para clientes em diferentes domínios.
Ao usar drives compartilhados para colaborar em projetos do Apps Script:
- Os colaboradores com acesso de editor a um drive compartilhado podem criar ou mover novos arquivos para ele. Como editores de script, eles podem ver e editar projetos de scripts, executar código de script, criar novas versões de script e publicar complementos.
- Para implantar scripts como apps da Web ou executáveis para a API Apps Script, a conta que cria a implantação precisa pertencer ao mesmo domínio da unidade compartilhada em que o script está localizado.
- Com os drives compartilhados, você pode compartilhar arquivos específicos com pessoas de fora do grupo e atualizar as permissões de edição e visualização desses arquivos, assim como em qualquer outro arquivo do Drive. No entanto, se um usuário fizer parte da equipe a que o drive compartilhado pertence, não será possível reduzir o acesso dele a arquivos específicos. Por exemplo, se um usuário tiver acesso de edição a um drive compartilhado, não será possível mudar para acesso de visualização em um arquivo específico dentro do drive compartilhado.
- Os colaboradores com acesso total a um drive compartilhado também podem excluir arquivos e projetos do Apps Script, além de mover arquivos para fora do drive compartilhado.
- Todos os scripts vinculados ao contêiner usam as mesmas listas de acesso de leitor e editor definidas para o arquivo do contêiner. Por exemplo, se você tiver acesso de edição a uma planilha Google, também terá acesso de edição a qualquer código de projeto do Apps Script anexado a ela. Colocar um arquivo de contêiner em um drive compartilhado concede aos colaboradores do drive o mesmo acesso ao código do script que eles têm ao contêiner.
- Quando um projeto de script reside em um drive compartilhado, o acesso ao projeto do Google Cloud dele pode ser restrito. Consulte a seção do guia Projetos do Google Cloud e drives compartilhados para mais detalhes.
- Apps da Web implantados em um domínio param de funcionar se a propriedade deles mudar para um drive compartilhado ou conta em um domínio diferente. Para corrigir isso, mova o script de volta ao domínio original.
- Da mesma forma, os projetos de script implantados como um executável da API Apps Script param de funcionar quando chamados pela API se forem movidos de um domínio para outro usando o drive compartilhado. Para corrigir isso, mova o script de volta para o domínio original.
Colaborar com uma pasta compartilhada
Tenha cuidado ao criar ou mover um projeto do Apps Script para uma pasta compartilhada. Verifique se a pasta está compartilhada apenas com pessoas de confiança.
Se não for possível colaborar com um drive compartilhado, use uma pasta compartilhada. Quando você cria ou move um projeto do Apps Script para uma pasta do Drive que outras pessoas podem acessar, elas herdam o mesmo acesso ao projeto que têm à pasta. Exemplo:
- Se alguém tiver acesso de edição à pasta, poderá editar ou excluir o projeto do Apps Script e executar o script.
- Se alguém tiver apenas acesso de visualização à pasta, poderá ver o projeto do Apps Script e executar o script.
Colaborar com o compartilhamento de projetos
Colabore em um projeto compartilhando-o diretamente com todos os colaboradores. Compartilhe diretamente projetos de script que estão em pastas regulares do Drive ou em drives compartilhados. Planeje com cuidado quem vai ser o proprietário e manter o script ao longo do tempo.
Os projetos independentes aparecem no Drive como um arquivo. Compartilhe-os como qualquer outro arquivo. Para mais informações, consulte Como compartilhar arquivos e pastas.
Os projetos vinculados a contêineres não ficam visíveis no Drive. Para compartilhar um projeto vinculado a um contêiner, compartilhe o arquivo do contêiner pai. Por exemplo, se você tiver um script vinculado a uma planilha do Google Planilhas, torne alguém editor do script ao torná-lo editor da planilha. Os projetos vinculados a contêineres herdam as configurações de acesso de leitor e editor do arquivo de contêiner.
Todos os scripts vinculados ao contêiner usam a mesma lista de acesso de proprietário, leitor e acesso de edição definida para o arquivo do contêiner. O proprietário do contêiner assume a propriedade de um novo projeto de script, independentemente de quem o criou.
Colaboração e recursos do projeto
Recursos são entidades associadas ao projeto, mas que existem independentemente do código dele. Esta seção explica como a colaboração em um projeto afeta os recursos dele, principalmente: projeto do Google Cloud, acionadores, bibliotecas e propriedades do usuário.
Colaboração e projetos do Google Cloud
Todo projeto do Apps Script tem um projeto do Google Cloud associado. Os projetos do Google Cloud têm um conjunto próprio de proprietários, editores e outras funções, que podem ser diferentes do conjunto de usuários que podem acessar o projeto de script.
Colaboração e gatilhos
Quando você colabora em um projeto, os gatilhos instaláveis que você cria não são compartilhados com quem tem acesso ao projeto. Se você precisar de uma configuração de acionador consistente para todos os colaboradores, use o serviço de script para criar acionadores de maneira programática, durante a execução. Para mais informações, consulte Gerenciar acionadores de maneira programática.
colaboradores.
Colaboração e bibliotecas
As bibliotecas incluídas no projeto ficam disponíveis para os colaboradores dele. No entanto, se eles não tiverem pelo menos acesso de leitura a uma biblioteca incluída, não poderão usar essas bibliotecas. Nesse caso, o script vai gerar um erro. Para mais informações sobre bibliotecas, consulte Gerenciar bibliotecas.
Colaboração e propriedades do usuário
As propriedades do usuário são exclusivas do usuário que as criou. Isso significa que os colaboradores do projeto não podem ver nem acessar suas propriedades do usuário, e você não pode ver nem acessar as deles. Use propriedades de script se quiser compartilhar propriedades específicas do projeto com colaboradores. Para mais informações, consulte o guia de propriedades.