O painel do Apps Script permite gerenciar e monitorar seus projetos do Apps Script. Use o painel para fazer o seguinte:
- Veja e pesquise seus projetos do Apps Script, incluindo scripts vinculados anexados a documentosGoogle Workspace .
- Criar novos projetos.
- Confira detalhes sobre seus projetos, como os escopos do OAuth que eles usam.
- Monitore a integridade e o uso dos seus projetos de script.
- Veja os registros de execução dos seus projetos e de outros que são executados usando as credenciais da sua conta.
- Ative ou desative a API Apps Script para permitir ou impedir que os apps usem a API para interagir com seus projetos de script.
Ver e pesquisar projetos
O painel do Apps Script lista todos os projetos de script que você pode visualizar ou editar. A navegação à esquerda do painel divide esses projetos nas seguintes categorias:
- Projetos marcados com estrela. Projetos que você está monitorando.
- Meus projetos. Projetos em que você é proprietário.
- Todos os projetos. Projetos que são seus ou em que você tem permissões de leitura ou edição.
- Compartilhados comigo. Projetos que não são seus, mas foram compartilhados com você.
- Lixeira. Projetos que você removeu do Google Drive.
As listas de projetos mostram o nome, o proprietário e a data da última modificação. Os ícones ao lado do nome do projeto indicam se ele é independente ou vinculado.
Ver detalhes do projeto
Cada projeto inclui uma visualização para conferir detalhes do desenvolvedor sobre ele. Para ver os detalhes de um projeto, clique na linha da lista de projetos.
A visualização de detalhes do projeto mostra dados e gráficos de Taxa de erros, Execuções e Usuários sobre o projeto, além dos escopos do OAuth solicitados de qualquer usuário final que use o projeto. As métricas de dados são definidas da seguinte maneira:
- Taxa de erros. A porcentagem de execuções que não foram executadas devido a exceções não capturadas. Ele é calculado como o número de execuções com falha dividido pelo total de execuções no período definido.
- Execuções. O número de vezes que um projeto foi "executado". Consulte Tipos de execução para mais informações sobre como um projeto pode ser executado.
- Usuários. O número de usuários únicos (contas) que executaram o projeto uma ou mais vezes durante o período especificado. Os usuários anônimos não são rastreados e, portanto, não aparecem na contagem de usuários nem nos gráficos.
Cada implantação do projeto aparece como uma guia na página Detalhes do projeto acima dos dados e gráficos. Selecione a guia para conferir os dados associados a essa implantação. Selecionar TODOS mostra dados agregados de todas as implantações do projeto e das execuções resultantes de desenvolvedores que executam o projeto no editor de código do Apps Script.
Monitorar projetos
Talvez você tenha acesso a muito mais projetos do Apps Script do que usa ou gerencia regularmente. Para marcar projetos com estrela e facilitar o acesso, Ao marcar projetos com estrela, você também pode monitorar estatísticas e gráficos agregados de uso e taxa de erros nesses projetos.
Para adicionar uma estrela a um projeto, clique em Mais > Adicionar estrela à direita de uma linha do projeto. Você também pode marcar um projeto com estrela clicando em Mais ao visualizar os detalhes do projeto.
Na navegação à esquerda, selecione Projetos com estrela para ver os projetos que você marcou. Clique no card Taxa de erros, Execuções ou Usuários na parte de cima da página para conferir os gráficos associados de todos os seus projetos marcados com estrela nos últimos sete dias.
Para remover uma estrela de um projeto, clique em Mais na linha do projeto e selecione Remover estrela.
Gerenciar execuções
Use o painel do Apps Script para ver e gerenciar execuções individuais de funções do projeto do Apps Script. Para conferir um registro completo das execuções recentes, selecione o item Minhas execuções na navegação à esquerda.
Por padrão, o painel Minhas execuções mostra um registro de todas as execuções anteriores e atuais de projetos em que você é proprietário, editor ou leitor. Essa lista também pode incluir execuções de funções em projetos a que você não tem acesso, se elas forem executadas em seu nome (por exemplo, complementos instalados e executados). A lista de execução mostra apenas a função inicial que é chamada para iniciar a execução. Ele não mostra todas as funções que foram chamadas durante essa execução.
É possível controlar qual tipo de execução é informado no registro usando os filtros na parte de cima da visualização. Cada linha do registro representa uma única execução. As colunas Hora de início, Duração e Status mostram as informações correspondentes sobre essa execução.
A coluna Função mostra o nome da função que iniciou a execução. Não há um nome nessa coluna se você não tiver acesso ao projeto de script correspondente da execução, mas ele foi executado em seu nome.
A coluna Tipo mostra o que iniciou a execução. Os valores incluem:
- Adicionar complemento. A execução foi originada de um complemento.
- API Execution. A execução foi originada de uma invocação da API Apps Script.
- Baseado em tempo. A execução foi causada por um evento de tempo.
- Gatilho. A execução se originou de uma fonte de gatilho.
- Webapp. A execução se originou de um app da Web implantado.
- Editor. A execução foi originada no editor do Apps Script.
Encerrar execuções
Execuções de longa duração que estão em andamento são indicadas por um Status "Em execução". Para interromper essas execuções, à direita da linha do projeto, clique em Mais > Encerrar.
Configurações
Para ajustar as configurações do painel, selecione Configurações na navegação à esquerda.
No painel Configurações, há uma chave para a API Apps Script. Isso permite que você conceda à API acesso aos seus projetos de script.
Para acessar essa opção, clique no rótulo API Google Apps Script no painel Configurações. Um novo painel será aberto com um texto de aviso e um botão de alternância. O acesso aos projetos de script é desativado por padrão como uma precaução de segurança. Depois de conceder acesso, qualquer aplicativo de terceiros autorizado pode usar a API para modificar seus scripts e implantações. Você pode revogar esse acesso no painel Configurações a qualquer momento.
Encontre mais informações no guia de acesso à API Apps Script.