O painel do Apps Script

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O painel do Apps Script permite gerenciar e monitorar seus projetos do Apps Script. Você pode usar o painel para realizar qualquer uma das seguintes ações:

  • Veja e pesquise seus projetos do Apps Script, incluindo scripts vinculados anexados a documentosGoogle Workspace .
  • Criar projetos
  • Veja detalhes sobre seus projetos, como os escopos do OAuth que ele usa.
  • Monitore a integridade e o uso dos projetos de script.
  • Ver registros de execução de projetos e outros projetos que são executados usando as credenciais da sua conta.
  • Ative ou desative a API Apps Script para permitir ou impedir que 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 ver ou editar. O painel de navegação à esquerda divide esses projetos nas seguintes categorias:

  • Projetos com estrela Projetos que você está monitorando.
  • Meus projetos. Projetos em que você é proprietário
  • Todos os projetos. projetos que você tem ou tem permissões para ver ou editar.
  • 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 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 é um projeto independente ou vinculado.

Ver detalhes do projeto

Cada projeto inclui uma visualização para ver detalhes do desenvolvedor sobre ele. Para ver os detalhes de um projeto, clique na linha da lista.

A visualização de detalhes do projeto mostra dados e gráficos de taxa de erro, execuções e usuários sobre o projeto, além de escopos do OAuth solicitados de qualquer usuário final que use o projeto. As métricas de dados são definidas da seguinte forma:

  • Taxa de erros. A porcentagem de execuções que não foram executadas devido a exceções não capturadas. Esse valor é 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 "run" ou executado. Consulte Tipos de execução para mais informações sobre como um projeto pode ser executado.
  • Usuários. Número de usuários únicos (contas) que executaram o projeto uma ou mais vezes no 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 a guia para ver os dados associados a essa implantação. Selecionar TODOS mostra dados agregados de 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

Você pode ter acesso a mais projetos do Apps Script do que usa ou gerencia regularmente. Para marcar os projetos como favoritos para facilitar o acesso, marque-os com estrela. Marcar projetos com estrela também permite monitorar estatísticas e gráficos agregados de uso e taxa de erros 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 e visualizar os detalhes do projeto.

Na navegação à esquerda, você pode selecionar Projetos com estrela para ver os projetos que foram adicionados aos favoritos. Clique na visão geral Taxa de erro, Execuções ou Usuários na parte superior da página para ver os gráficos associados de todos os projetos 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 visualizar e gerenciar execuções individuais de funções do projeto do Apps Script. Para ver um registro completo das execuções recentes, selecione o item Minhas execuções na navegação à esquerda.

O painel Minhas execuções mostra, por padrão, um registro de todas as execuções anteriores e em execução de 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 forem executadas 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. Ela não mostra todas as funções que foram chamadas durante essa execução.

É possível controlar o tipo de execução que é relatado 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 nessa coluna se você não tiver acesso ao projeto de script correspondente da 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 de um complemento.
  • API Execution. A execução veio de uma invocação da API Apps Script.
  • Baseado no tempo. A execução foi causada por um evento de tempo.
  • Gatilho. A execução veio de uma origem do gatilho.
  • Aplicativo da Web. A execução veio 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 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 no painel de navegação à esquerda.

No painel Configurações, há uma alternância da API Apps Script. Isso permite que a API acesse 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 uma chave de alternância. O acesso aos seus projetos de script é desativado por padrão como precaução de segurança. Depois de conceder acesso, qualquer aplicativo de terceiros que você autorizar poderá usar a API para modificar os scripts e 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.

Suporte

Se você encontrar um erro ou precisar de ajuda para usar o painel do Apps Script, comece pesquisando ou postando no Stack Overflow:

Fazer uma nova pergunta

Bugs

Se você determinou que a causa de um problema é devido a um bug no painel, você pode pesquisar nosso Issue Tracker para determinar se é um problema conhecido. Se for, marque o problema com uma estrela (clique na Estrela ao lado do número do problema). Nós priorizamos bugs que recebem mais estrelas. Também é possível adicionar comentários a problemas atuais para contextualizar ou dar mais informações sobre eles.

Se o problema for completamente novo, informe no Rastreador de problemas. Se fizer isso, inclua as seguintes informações na descrição do bug:

  • Uma descrição do problema e o comportamento que você esperava
  • Uma lista de etapas que podem ser usadas para reproduzir o problema.
  • Uma descrição da saída esperada e do que realmente aconteceu. Inclua todas as mensagens de erro recebidas
  • informações sobre o ambiente de desenvolvimento, incluindo linguagem de programação, versões de bibliotecas etc.

Esteja ciente de que os problemas podem ficar sem respostas por um tempo. Isso não significa que nunca corrigiremos um problema, mas sim que não há atualizações no momento.

Informar um novo bug

Recursos em falta

Se houver um recurso ou funcionalidade ausente do painel que você quer ter, você pode pesquisar nosso Issue Tracker para determinar se outros o solicitaram. Se já tiver sido solicitado, marque o problema com uma estrela (clique na estrela ao lado do número do problema). Nós priorizamos bugs que recebem mais estrelas. Também é possível adicionar comentários a problemas atuais para contextualizar ou dar mais informações sobre eles.

Se o recurso ainda não tiver sido solicitado, faça uma solicitação de recurso no Rastreador de problemas. Descreva a funcionalidade específica que você quer que adicionemos e por que você a acha importante. Se possível, inclua detalhes específicos sobre seu caso de uso e as novas oportunidades que o recurso poderia criar.

Solicitar um novo recurso