O painel do Apps Script permite gerenciar e monitorar seus projetos do Apps Script. Você pode usar o painel para realizar as seguintes ações:
- Consulte e pesquise seus projetos atuais do Apps Script, incluindo scripts vinculados aGoogle Workspace documentos.
- Criar novos projetos.
- Veja os detalhes dos projetos, como os escopos do OAuth usados.
- Monitore a integridade e o uso dos seus projetos de script.
- Acesse 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.
Acessar e pesquisar projetos
O painel do Apps Script lista todos os projetos de script que você pode ver ou editar. A navegação à esquerda do painel divide esses projetos nas seguintes categorias:
- Projetos com estrela. projetos que você está monitoring;
- Meus projetos. Projetos dos quais você é proprietário.
- Todos os projetos. Projetos que pertencem a você ou para os quais você tem permissões de leitura e edição.
- Compartilhados comigo. Projetos que não são de sua propriedade, mas que foram compartilhados com você.
- Lixeira. projetos removidos do Google Drive.
As listas de projetos mostram o nome, o proprietário e a data da última modificação do projeto. Os ícones ao lado do nome do projeto indicam se ele é independente ou vinculado.
Mais detalhes do projeto
Cada projeto inclui uma visualização para mostrar os detalhes do desenvolvedor sobre o projeto. Para visualizar os detalhes de um projeto, clique na linha na lista de projetos.
A visualização de detalhes do projeto mostra dados e gráficos de Taxa de erros, Execuções e Usuários, 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 detectadas. Ela é calculada como execuções com falha divididas pelo total de execuções durante o período definido.
- Execuções. O número de vezes que um projeto foi "executado" ou 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. Usuários anônimos não são rastreados e, portanto, não são refletidos na contagem ou nos gráficos de usuários.
Cada implantação do seu projeto aparece como uma guia na página Detalhes do projeto acima dos dados e gráficos. Selecione a guia para ver os dados associados à implantação. Selecionar TODOS mostra os dados agregados de todas as implantações do projeto e das execuções resultantes dos desenvolvedores que executam o projeto no editor de código do Apps Script.
Monitorar projetos
Você pode ter acesso a muito mais projetos do Apps Script do que usa ou gerencia regularmente. Para adicionar projetos aos favoritos e facilitar o acesso, é possível marcá-los com uma estrela. Marcar projetos com estrela também permite monitorar estatísticas e gráficos de uso e taxa de erro agregados nesses projetos.
Para marcar um projeto com estrela, à direita de uma linha do projeto, clique em Mais > Adicionar estrela. Também é possível marcar um projeto com estrela clicando em Mais ao visualizar os detalhes do projeto.
Na navegação à esquerda, é possível selecionar Projetos com estrela para ver os projetos que você adicionou aos favoritos. Clique na visão geral Taxa de erros, Execuções ou Usuários na parte de cima da página para conferir os gráficos associados a todos os projetos com estrela nos últimos 7 dias.
Para remover uma estrela de um projeto, clique em Mais na linha do projeto e selecione Remover estrela.
Gerenciar execuções
Você pode usar o painel do Apps Script para visualizar e gerenciar execuções individuais de funções de projeto do Apps Script. Para ver um registro completo das execuções recentes, selecione o item My Executions na navegação à esquerda.
O painel My Executions mostra, por padrão, um registro de todas as execuções anteriores e atuais dos projetos em que você é proprietário, editor ou leitor. Essa lista também pode incluir execuções de função em projetos aos quais você não tem acesso se eles forem executados em seu nome (por exemplo, complementos que você instalou e executou). 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 chamadas durante a execução.
É possível controlar o tipo de execução informado no registro usando os filtros na parte superior da visualização. Cada linha do registro representa uma única execução. As colunas Horário de início, Duração e Status mostram as informações correspondentes sobre a execução.
A coluna Função mostra o nome da função que iniciou a execução. Não haverá nome nessa coluna se você não tiver acesso ao projeto de script correspondente à execução, mas ele tiver sido executado em seu nome.
A coluna Tipo mostra o que iniciou a execução. Os valores incluem:
- Complemento. A execução originou-se de um complemento.
- API Execution. A execução originou-se de uma invocação da API Apps Script.
- Baseado no tempo. A execução foi causada por um evento de horário.
- Gatilho. A execução originou-se de uma fonte de acionador.
- Webapp. A execução originou-se de um app da Web implantado.
- Editor. A execução teve origem 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
Ajuste as configurações do painel selecionando Configurações na navegação à esquerda.
No painel Configurações, há um botão para ativar/desativar a API Apps Script. Isso permite que você conceda à API acesso aos seus projetos de script.
Para acessá-lo, clique no marcador API Google Apps Script no painel Configurações. Isso abre um novo painel com o texto de aviso e um botão de ativação. O acesso aos seus projetos de script é desativado por padrão como uma precaução de segurança. Depois de conceder o acesso, qualquer aplicativo de terceiros que você autorizar poderá usar a API para modificar os scripts e as implantações. É possível revogar esse acesso no painel Configurações a qualquer momento.
Veja mais informações no guia de acesso da API Apps Script.