Painel do Apps Script

No painel do Apps Script, você pode gerenciar e monitorar seus projetos do Apps Script. É possível usar o painel para fazer o seguinte:

  • Veja e pesquise seus projetos do Apps Script, incluindo scripts vinculados anexados a documentosGoogle Workspace .
  • Criar novos projetos.
  • Veja detalhes sobre os projetos, como os escopos do OAuth usados.
  • Monitore a integridade e o uso dos 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.

Acessar e pesquisar projetos

O painel do Apps Script lista todos os projetos de script que você pode ver ou editar. O painel de navegação à esquerda divide esses projetos nas seguintes categorias:

  • Projetos com estrela. Projetos que você está monitoring.
  • Meus projetos. projetos de que você é um proprietário;
  • Todos os projetos. seus projetos ou em que você tem permissões para 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 do projeto, o proprietário e a data da última modificação. 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 ver os detalhes do desenvolvedor sobre o projeto. Para ver os detalhes de um projeto, clique na linha na lista de projetos.

A visualização de detalhes do projeto mostra dados e gráficos da Taxa de erros, Execuções e Usuários sobre ele, bem como escopos do OAuth solicitados de 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 em função de exceções não capturadas. Ela é calculada como as execuções com falha divididas pelo total de execuções durante o período de tempo definido.
  • Execuções. O número de vezes que um projeto foi "executado" ou foi executado. Consulte os 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 de usuários ou nos gráficos.

Cada implantação do seu projeto aparece como uma guia na página Detalhes do projeto, acima dos dados e gráficos. É possível selecionar essa guia para ver os dados associados à implantação. Selecionar ALL mostra dados agregados para todas as implantações do projeto e de 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. Marque projetos com estrela para facilitar o acesso a eles. Ao marcar projetos com estrela, você também pode monitorar o uso agregado e as estatísticas de taxa de erros e gráficos nesses projetos.

Para marcar um projeto com estrela, à direita de uma linha do projeto, clique em More > Add Star. Também é possível marcar um projeto com estrela clicando em Mais ao ver os detalhes do projeto.

No painel de navegação à esquerda, selecione Projetos com estrela para conferir os projetos que foram adicionados aos favoritos. Clique na visão geral Taxa de erros, Execuções ou Usuários na parte superior da página para ver os gráficos associados a todos os projetos com estrela nos últimos sete dias.

Para remover uma estrela de um projeto, clique em More na linha do projeto e selecione Remove estrela.

Gerenciar execuções

Você pode usar o painel do Apps Script para visualizar e gerenciar execuções individuais das funções de projeto do Apps Script. Para encontrar um registro completo de 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 dos quais você é proprietário, editor ou leitor. Essa lista também pode incluir execuções de funções em projetos aos quais você não tem acesso, caso sejam executados em seu nome (por exemplo, complementos instalados e executados). A lista de execução mostra apenas a função inicial chamada para iniciar a execução. Ele não mostra todas as funções chamadas durante essa execução.

É possível controlar qual 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 essa 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 ao projeto de script correspondente à execução, mas ele for executado em seu nome.

A coluna Tipo mostra o que iniciou a execução. Os valores incluem:

  • Complemento. A execução foi originada de um complemento.
  • API Execution. A execução se originou 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 se originou de uma origem de gatilho.
  • Webapp: A execução foi originada de um app da Web implantado.
  • Editor. A execução é originada do 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

Você pode ajustar as configurações do painel selecionando 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 acessá-lo, 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. O acesso aos projetos de script é desativado por padrão como medida de segurança. Depois que o acesso for concedido, 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.