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 devem ter acesso de editor ao arquivo de projeto do Apps Script (e ao contêiner dele, se for um script vinculado). Assim, todos da equipe ver e fazer alterações no código do Apps Script. Os editores também podem criar um novo código publicar complementos e implantar scripts como apps da Web ou a API Apps Script.
Você pode ajudar sua equipe planejando de antemão como lidar com a edição, a revisão, o controle de versões e, se aplicável, a implantação e publicação como um projeto, um complemento ou um aplicativo da Web. Projetos autônomos geralmente são a forma mais fácil colaborar, porque eles aparecem diretamente no Google Drive e são os tipo de projeto recomendado para o desenvolvimento de complementos e apps da Web.
Um problema comum na colaboração ocorre quando um proprietário de projeto de script deixa o equipe sem transferir a propriedade do projeto para outra pessoa da equipe. Isso pode impedir a manutenção ou atualização do projeto. Ao colocar seu projeto de script em um drive compartilhado impede esse problema, já que os arquivos em um drive compartilhado não têm proprietários específicos.
Colaborar com a ferramenta de linha de comando clasp
Com o clasp, é possível sincronizar projetos entre o script.google.com e o arquivo local.
sistema. Isso permite simplificar e automatizar o desenvolvimento de código
e seus colaboradores estejam usando um software de gerenciamento de controle de origem, como
git:
Para mais detalhes, consulte Interface de linha de comando
usando o guia do clasp.
Colaborar com drives compartilhados
Drives compartilhados (antes conhecidos como "Drives de equipe") são um espaço compartilhado em que os grupos do Drive os usuários podem colaborar de forma mais eficaz. Os arquivos armazenados em um drive compartilhado são de sua propriedade pelo grupo como um todo, e não por indivíduos. Isso significa que, quando um o colaborador sai do grupo do qual não tem propriedade nem controle dos arquivos para resolvê-los com rapidez.
Com os drives compartilhados, você também pode mover arquivos entre domínios, ou seja, um drive compartilhado de um domínio podem ter colaboradores de outro domínio para mover arquivos esse domínio ao drive compartilhado. Isso pode ser muito valioso para o Apps Script desenvolvedores, pois fornece um meio para que uma equipe desenvolva complementos, aplicativos da web ou outro código para clientes em domínios diferentes.
Ao usar drives compartilhados para colaborar em projetos do Google Apps Script, mantenha o o seguinte:
- Os colaboradores com acesso de editor a um drive compartilhado podem criar ou mover novos arquivos no drive compartilhado. Como editores de script, eles podem visualizar e editar projetos de scripts, executar códigos de script, criar novas versões de scripts, e publicar complementos.
- Para implantar scripts como apps da Web ou executáveis na API Apps Script, faça o seguinte: a conta que cria a implantação precisa pertencer ao mesmo domínio do drive compartilhado em que o script está.
- Com os drives compartilhados, você pode compartilhar arquivos específicos com outras pessoas fora do grupo e atualizem suas permissões de edição e visualização no esses arquivos como qualquer outro arquivo do Drive. No entanto, se um usuário parte do equipe a que o drive compartilhado pertence, não é possível reduzir o acesso a arquivos . Por exemplo, se um usuário tiver acesso para editar um drive compartilhado, não será possível altere-o para acesso somente visualização de um arquivo específico no drive compartilhado.
- Os colaboradores com acesso total a um drive compartilhado também podem excluir arquivos e do Apps Script e migrar arquivos do drive compartilhado.
- Todos os scripts vinculados a contêineres use as mesmas listas de acesso de leitor e editor definidas para o arquivo de contêiner. Por exemplo, se você tem acesso para editar uma Planilha Google, também para editar qualquer código de projeto do Apps Script anexado a ele. Colocar um arquivo de contêiner em um drive compartilhado concede aos colaboradores desse drive o mesmo acesso ao código do script que têm para o próprio contêiner.
- Quando um projeto de script está em um drive compartilhado, você tem acesso aos Projeto do Cloud Platform (GCP) podem ser restritas. Consulte a Projetos do GCP e drives compartilhados para mais detalhes.
- Apps da Web implantados em um domínio deixam de funcionar se sua propriedade muda para um um drive compartilhado ou uma conta em outro domínio. Isso pode ser corrigido mover o script de volta para o domínio original.
- Da mesma forma, projetos de script que são implantado como executável da API Apps Script deixam de funcionar quando chamados pela API se forem movidos pelo drive compartilhado de de um domínio para outro. Isso pode ser corrigido ao mover o script de volta para domínio original.
Colaborar usando uma pasta compartilhada
Se não for possível colaborar em um drive compartilhado, use uma pasta compartilhada, como alternativa. Quando você cria ou move um projeto do Apps Script para Pasta do Google Drive que outras pessoas podem acessar, elas herdam o mesmo acesso para o projeto do Apps Script na pasta. Exemplo:
- Se alguém tiver acesso para editar a pasta, essa pessoa poderá editar ou excluir o projeto do Apps Script e execute o script.
- Se uma pessoa só tiver acesso de leitura à pasta, ela poderá ver projeto do Apps Script e execute o script.
Colabore usando o compartilhamento de projetos
Você pode colaborar em um projeto compartilhando-o diretamente com todos os colaboradores. É possível compartilhar diretamente projetos de script que residem em ambientes em pastas do Google Drive ou em drives compartilhados. Se você usar esse método, recomendado que você planeje cuidadosamente quem é o proprietário e o responsável pela manutenção do script ao longo do tempo.
Os projetos independentes 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 nas Google Drive Para compartilhar um projeto vinculado a um contêiner, compartilhe o projeto pai do arquivo de contêiner. Por exemplo, se você tem um script vinculado a um arquivo do Planilhas Google planilha, você pode tornar alguém editor do script. planilha. Projetos vinculados a contêineres herdam o acesso de leitor e editor do arquivo de contêiner.
Todos os scripts vinculados a contêiner usam o mesmo proprietário, leitor e lista de acesso de 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.
Colaboração e recursos do projeto
Recursos são entidades associadas ao projeto, mas que existem independentemente do código. Esta seção explica como colaborar em um projeto afeta os recursos, em especial: o projeto do Cloud Platform, gatilhos, bibliotecas e propriedades do usuário.
Colaboração e projetos do Google Cloud
Todo projeto do Apps Script tem um link Projeto do Google Cloud. Os projetos do Google Cloud têm um conjunto próprio de proprietários, editores e outros papéis, que pode ser diferente do conjunto de usuários que podem acessar o script projeto.
Se você pretende publicar seu projeto de script como um complemento, será necessário usar um projeto padrão do Google Cloud. Quando você colabora em um aplicativo que usa um projeto padrão do Google Cloud, nós recomendamos que você configura os proprietários e papéis do Google Cloud para garantir que todos os colaboradores tenham os níveis de acesso adequados. Isso ajuda evitar situações em que você perca o acesso às configurações de nuvem do projeto devido a os proprietários dela não estão mais na organização. Isso é especialmente importante. para complementos.
Colaboração e gatilhos
Quando você colabora em um projeto, acionadores instaláveis criados por você. não são compartilhadas com aqueles que têm acesso ao projeto. Se você precisar ter uma configuração de acionador consistente para todos os colaboradores, é possível usar o Serviço de script para criar gatilhos programaticamente, no ambiente de execução. Para mais informações, consulte Como gerenciar acionadores programaticamente.
Colaboração e bibliotecas
As bibliotecas incluídas no projeto ficam disponíveis para os colaboradores. No entanto, se eles não tiverem pelo menos acesso de leitura a uma biblioteca incluída não podem usar essas bibliotecas. Nesse caso, o script gera um erro. Para mais informações sobre bibliotecas, consulte Como gerenciar bibliotecas.
Colaboração e propriedades do usuário
Propriedades do usuário são exclusivos do usuário que os criou. Isso significa que os colaboradores do projeto não podem ver ou acessar suas propriedades de usuário, e você não podem ver ou acessar as deles. Usar propriedades do script se quiser compartilhar propriedades específicas do projeto com os colaboradores. Para mais informações, consulte a Guia de propriedades.