Entenda projetos, serviços e execução
Um projeto contém código e configurações capazes de chamar serviços compatíveis em um contexto de autorização. Um script vinculado a um documento tem uma estrutura diferente da de um projeto independente. Comece identificando a conta, os arquivos e as interfaces externas envolvidos. Esta página trata dos conceitos da plataforma; o guia do projeto apresenta um exemplo simples de fila de revisão.
- ✓ Use um projeto de teste e registros de amostra não confidenciais.
- ✓ Consulte a documentação oficial atualizada sobre os serviços e a configuração compatíveis.
Trate permissões e gatilhos como decisões de design
A autorização determina a que o código pode acessar, enquanto os acionadores determinam quando e sob o contexto de quem ele é executado. Antes de agendar a execução, analise os escopos solicitados e a propriedade contínua. Não exponha valores confidenciais no código-fonte público nem nas células de planilhas. O tempo de execução e as cotas dos serviços limitam o tamanho da carga de trabalho; seus valores atuais devem ser verificados, em vez de reproduzidos indefinidamente em um guia.
- ✓ Solicite apenas o acesso necessário para a tarefa.
- ✓ Documente quem é responsável pelos gatilhos e como desativá-los.
Entenda o comportamento confiável antes de adicionar recursos
Trate explicitamente entradas vazias, linhas inválidas, solicitações com falha e execuções repetidas. Registre logs claros sem expor dados pessoais nem segredos. Prefira funções pequenas, com entradas e saídas previsíveis, e depois verifique os resultados esperados em um conjunto de dados conhecido. Uma execução manual deve ser compreensível antes que o script se torne uma dependência operacional executada sem supervisão.
- ✓ Mantenha um backup dos dados originais e instruções de recuperação.
- ✓ Avance para o exemplo de projeto quando os conceitos principais estiverem claros.