Painel do Apps Script

O painel do Apps Script permite gerenciar e monitorar seus projetos do Google Apps Script. Você pode usar o painel para fazer qualquer o seguinte:

  • Consulte e pesquise seus projetos do Apps Script, incluindo scripts bound anexados ao Google Workspace documentos.
  • Criar novos projetos.
  • Confira os detalhes dos seus projetos, como os escopos OAuth que ele usa.
  • 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 o credenciais.
  • 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 nos seguintes categorias:

  • Projetos com estrela. projetos que você está monitorando;
  • 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 seus, 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. A Os ícones ao lado do nome do projeto indicam se ele é um independente projeto 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 da lista de projetos.

A visualização de detalhes do projeto mostra Taxa de erros, Execuções e Usuários. dados e gráficos sobre o projeto, bem como Escopos do OAuth solicitados a 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 identificadas. Ela é calculada como execuções com falha divididas pelas o total de execuções no período definido.
  • Execuções. o número de vezes que um projeto foi "executado" ou executados. Consulte Tipos de execução para mais informações sobre como uma em que o projeto possa ser executado.
  • Usuários. O número de usuários únicos (contas) que executaram o projeto um ou mais vezes durante o período especificado. Usuários anônimos não são rastreados portanto, não são refletidas 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, você pode selecionar a guia para os dados associados à implantação. Selecionar TODOS os programas agregar dados de todas as implantações do projeto e das execuções resultantes de desenvolvedores que executam o projeto no Apps Script editor de código.

Monitorar projetos

Você pode ter acesso a muito mais projetos do Apps Script do que usa ou com frequência. 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 agregadas de uso e taxa de erros e gráficos nesses projetos.

Para marcar um projeto com estrela, clique em Mais à direita da linha dele. > Adicionar estrela. Também é possível marcar um projeto com estrela clicando em Mais ao visualizar os detalhes do projeto.

No painel de navegação à esquerda, selecione Projetos com estrela para vê-los. que você adicionou aos favoritos. Clique em Taxa de erros, Execuções ou Usuários. visão geral na parte superior da página para ver os gráficos associados a todas as suas projetos com estrela nos últimos 7 dias.

Para remover uma estrela de um projeto, clique em "Mais" na linha do projeto e selecionando Remover estrela.

Gerenciar execuções

É possível usar o painel do Apps Script para visualizar e gerenciar execuções individuais das funções de projeto do Apps Script. Você pode encontrar um registro completo execuções selecionando o item My Executions na navegação à esquerda.

O painel Minhas execuções mostra por padrão um registro de todas as atividades anteriores e atuais execuções de projetos dos quais você é proprietário, editor ou visualizador Essa lista também pode incluir execuções de função em projetos que você não têm acesso se forem executados em seu nome (por exemplo, complementos que que você instalou e executou). A lista de execução mostra apenas a função inicial que é chamado para iniciar a execução. Ele não mostra todas as funções que foi chamado durante a execução.

É possível controlar que tipo de execução é informado no registro usando o método na parte superior da visualização. Cada linha do registro representa execução. As colunas Horário de início, Duração e Status mostram os 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 nesta coluna se você não tiver acesso a o 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 originou-se de um complemento.
  • API Execution. A execução originou-se de uma invocação do 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 do projeto linha, clique em Mais > Encerrar.

Configurações

Para ajustar as configurações do seu painel, selecione Configurações na navegação esquerda.

No painel Configurações, há um botão de alternância para a API Apps Script. Isso permite que você conceda à API acesso aos seus projetos de script.

Para acessar esse botão, clique na API Google Apps Script. rótulo no painel Configurações. Isso abre um novo painel com o texto de aviso e um botão de ativação/desativação. O acesso aos seus projetos de script fica desativado por padrão como uma precaução de segurança. Depois de conceder acesso, os aplicativos de terceiros que você autorizar pode usar a API para modificar seus scripts e implantações. Você pode revogar esse acesso no painel Configurações a qualquer momento.

Confira mais informações na Guia de acesso à API Apps Script.