O Apps Script fornece alguns recursos que ajudam você e outros desenvolvedores a criar e manter scripts, complementos e apps da Web juntos.
Noções básicas de colaboração
Para colaborar em um projeto, você e seus colaboradores precisam ter acesso de editor ao arquivo de projeto do Apps Script (e ao contêiner, se for um script vinculado). Isso permite que todos na sua equipe vejam e façam alterações 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.
Você pode ajudar sua equipe planejando com antecedência como lidar com a edição, revisão, controle de versões e, se aplicável, a implantação e a publicação do projeto, complemento ou app da Web. Os projetos independentes geralmente são mais fáceis de colaborar, porque aparecem diretamente no Google Drive e são o tipo de projeto recomendado para complemento e desenvolvimento de apps da Web.
Um problema comum na colaboração ocorre quando um proprietário do projeto de script sai da equipe sem transferir a propriedade do projeto para outra pessoa da equipe. Isso pode fazer com que você não consiga manter ou atualizar 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.
Colaboração 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
git.
Consulte o guia Interface de linha de comando usando clasp para mais detalhes.
Como colaborar com drives compartilhados
Os drives compartilhados (anteriormente conhecidos como "Drives de equipe") oferecem um espaço compartilhado no Google Drive, onde grupos de usuários do Drive podem colaborar com mais eficiência. Os arquivos em um drive compartilhado pertencem ao grupo como um todo, não a pessoas específicas. Isso significa que, quando um colaborador sai do grupo, ele não assume a propriedade e o controle do arquivo.
Os drives compartilhados também permitem que você mova 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 pode ser muito valioso para os desenvolvedores do Apps Script, já que fornece meios para uma equipe desenvolver complementos, apps da Web ou outro código para clientes em domínios diferentes.
Ao usar drives compartilhados para colaborar em projetos do Apps Script, lembre-se do seguinte:
- Os colaboradores com acesso de editor a um drive compartilhado podem criar ou mover novos arquivos para o drive compartilhado. Como editores de script, eles podem visualizar e editar projetos de scripts, executar códigos de script, criar novas versões de script, publicar complementos.
- Para implantar scripts como aplicativos da Web ou executáveis para a API Apps Script, a conta que cria a implantação precisa pertencer ao mesmo domínio que o drive compartilhado em que o script reside.
- Os drives compartilhados permitem que você compartilhe arquivos específicos dentro do drive compartilhado com outras pessoas fora do grupo e atualize as permissões de edição e visualização nesses arquivos, como 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 para edição a um drive compartilhado, não será possível mudar essa configuração para acesso somente visualização a um arquivo específico no drive compartilhado.
- Os colaboradores com acesso total a um drive compartilhado, além dos citados acima, podem excluir arquivos e projetos do Apps Script e mover arquivos para fora do drive compartilhado.
- Todos os scripts vinculados ao contêiner usam as mesmas listas de acesso de visualizador e editor definidas para o arquivo de contêiner. Por exemplo, se você tiver acesso para 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 esse 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 no próprio contêiner.
- Quando um projeto de script reside em um drive compartilhado, o acesso ao projeto do Cloud Platform (GCP) pode ser restrito. Consulte a seção do guia Projetos do GCP e drives compartilhados para mais detalhes.
- Os apps da Web implantados em um domínio deixarão de funcionar se a propriedade deles mudar para um drive compartilhado ou uma conta em outro domínio. Isso pode ser corrigido movendo o script de volta para o domínio original.
- Da mesma forma, os projetos de script que são implantados como um executável da API Apps Script param de funcionar quando chamados pela API se movidos por drive compartilhado de um domínio para outro. Isso pode ser corrigido movendo o script de volta para o domínio original.
Como colaborar com o compartilhamento do projeto
Você também pode colaborar em um projeto compartilhando-o diretamente com todos os colaboradores. É possível compartilhar diretamente projetos de script que residem em pastas comuns do Google Drive ou em drives compartilhados. Se você usar esse método, recomendamos planejar cuidadosamente quem detém e mantém o script ao longo do tempo.
Os projetos autônomos aparecem no Google Drive como um arquivo, e você pode compartilhá-los como qualquer outro arquivo. Para mais informações, consulte Como compartilhar arquivos e pastas.
Projetos vinculados a contêineres não são visíveis a partir do Google Drive. Para compartilhar um projeto vinculado a um contêiner, compartilhe o arquivo pai do contêiner. Por exemplo, se você tiver um script vinculado a uma planilha do Planilhas Google, poderá torná-lo um editor da planilha. Os projetos vinculados a contêineres herdam as configurações de acesso de visualizador e editor do arquivo de contêiner.
Todos os scripts vinculados a contêineres usam a mesma lista de acesso de proprietário, leitor e editor definida para o arquivo de contêiner. O proprietário do contêiner assume a propriedade de um novo projeto de script, independentemente de quem o criou.
Como colaborar e projetar recursos
Recursos são entidades associadas ao projeto, mas que existem independentemente do código. Nesta seção, explicamos como a colaboração em um projeto afeta os recursos dele, principalmente o projeto do Cloud Platform, os acionadores, as bibliotecas e as 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 o próprio conjunto de proprietários, editores e outros papéis, que podem ser diferentes do conjunto de usuários que podem acessar o projeto de script.
Se você quiser publicar seu projeto de script como um complemento, use um projeto padrão do Google Cloud. Ao colaborar em um aplicativo que usa um projeto padrão do Google Cloud, recomendamos configurar os proprietários e papéis do Google Cloud para garantir que todos os colaboradores tenham os níveis de acesso adequados. Isso ajuda a evitar situações em que você perca o acesso às configurações do Cloud do projeto porque os proprietários não estão mais com sua organização. Isso é especialmente importante para complementos.
Colaboração e acionadores
Quando você colabora em um projeto, os acionadores instaláveis criados não são compartilhados com quem tem acesso ao projeto. Se você precisar ter uma configuração de acionador consistente para todos os colaboradores, use o serviço de script para criar acionadores de maneira programática, no tempo de execução. Para mais informações, consulte Como gerenciar acionadores de maneira programática.
Colaboração e bibliotecas
As bibliotecas incluídas no projeto estão disponíveis para colaboradores do projeto. No entanto, se eles não tiverem pelo menos o nível de leitura para uma biblioteca incluída, não poderão usar essas bibliotecas. Nesse caso, o script gerará um erro. Para mais informações sobre bibliotecas, consulte Como 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 as propriedades do usuário, nem você nem as deles. Use propriedades de script se quiser compartilhar propriedades específicas do projeto com os colaboradores. Para mais informações, consulte o guia de propriedades.