O Painel do Apps Script permite gerenciar e monitorar seus projetos do Apps Script. Você pode usar o painel para fazer o seguinte:
- Visualizar e pesquisar seus projetos atuais do Apps Script, incluindo scripts vinculados anexados a documentos .
- Criar novos projetos.
- Confira detalhes sobre seus projetos, como os escopos do OAuth usados.
- Monitore a integridade e o uso dos seus projetos de script.
- Acessar 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.
Conferir e pesquisar projetos
O painel do Apps Script lista todos os projetos de script que você pode visualizar ou editar. O painel de navegação à esquerda divide esses projetos nas seguintes categorias:
- Projetos com estrela. Projetos que você monitora.
- Meus projetos. Projetos de que você é proprietário.
- Todos os projetos. Projetos que você possui ou para os quais tem permissões de visualização ou edição.
- Compartilhados comigo. Projetos que não são seus, mas que 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 do projeto. Os ícones ao lado do nome do projeto indicam se ele é independente ou vinculado.
Conferir detalhes do projeto
Cada projeto inclui uma visualização para conferir detalhes do desenvolvedor sobre o projeto. Para acessar os detalhes de um projeto, clique na linha na lista de projetos.
A visualização de detalhes do projeto mostra dados e gráficos sobre o projeto, como taxa de erros, execuções e usuários, além de escopos do OAuth solicitados por qualquer usuário final que usa o projeto. As métricas de dados são definidas da seguinte maneira:
- Taxa de erros. A porcentagem de execuções que falharam devido a exceções não detectadas. Ele é calculado como execuções com falha divididas 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 (contas) únicos que executaram o projeto uma ou mais vezes no período especificado. Os usuários anônimos não são rastreados e, portanto, não são refletidos na contagem de usuários ou nos gráficos.
Cada implantação do projeto aparece como uma guia na página Detalhes do projeto, acima dos dados e gráficos. Você pode selecionar a guia para conferir os dados associados a essa implantação. A seleção de ALL 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 muitos mais projetos do Apps Script do que usa ou gerencia regularmente. Para adicionar projetos aos favoritos e facilitar o acesso, você pode marcá-los com estrela. Os projetos com estrela também permitem monitorar estatísticas e gráficos de uso agregado e taxa de erros nesses projetos.
Para adicionar um projeto aos "Com estrela", clique em Mais > Adicionar estrela à direita da linha do projeto. Também é possível marcar um projeto com estrela clicando em Mais enquanto confere os detalhes do projeto.
No menu de navegação à esquerda, selecione Starred Projects para ver os projetos que você marcou. 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 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
Você pode usar o painel do Apps Script para conferir e gerenciar execuções individuais de funções do projeto do Apps Script. Para encontrar um registro completo das execuções recentes, selecione o item Minhas execuções no painel de navegação à esquerda.
O painel Minhas execuções mostra por padrão um registro de todas as execuções anteriores e em andamento de projetos em que você é proprietário, editor ou visualizador. 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 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 Start Time, Duration 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á nome nessa coluna se você não tiver acesso ao projeto de script correspondente da execução, mas ela foi executada em seu nome.
A coluna Tipo mostra o que iniciou a execução. Os valores incluem:
- Complemento. A execução foi originada por um complemento.
- API Execution. A execução teve origem em uma invocação da API Apps Script.
- Orientado por tempo. A execução foi causada por um evento de tempo.
- Gatilho. A execução teve origem em uma origem do acionador.
- Webapp. A execução teve origem em um app da Web implantado.
- Editor. A execução foi originada no editor do Apps Script.
Encerrar execuções
As execuções de longa duração que estão em andamento são indicadas por um Status de "Running". 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á um botão para ativar a API Apps Script. Isso permite que você conceda à API acesso aos seus projetos de script.
Para acessar esse botão, clique no rótulo API Google Apps Script no painel Configurações. Isso abre um novo painel com texto de aviso e um botão de alternância. Por padrão, o acesso aos seus projetos de script é desativado como uma precaução de segurança. Depois de conceder o acesso, qualquer aplicativo de terceiros autorizado poderá usar a API para modificar seus scripts e implantações. É possível revogar esse acesso no painel Configurações a qualquer momento.
Confira mais informações no guia de acesso à API Apps Script.