O painel do Apps Script permite gerenciar e monitorar seus projetos do Apps Script. Use o painel para:
- Ver e pesquisar seus projetos do Apps Script, incluindo scripts vinculados anexados a documentos do Google Workspace.
- Criar novos projetos.
- Ver detalhes sobre seus projetos, como os escopos OAuth usados.
- Monitorar a integridade e o uso dos seus projetos de script.
- Ver registros de execução dos seus projetos e de outros que são executados usando as credenciais da sua conta.
- Ativar ou desativar a API Apps Script para permitir ou impedir que os 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. A navegação à esquerda do painel divide esses projetos nas seguintes categorias:
- Projetos marcados com estrela. Projetos que você está monitorando.
- Meus projetos. Projetos dos quais você é proprietário.
- Todos os projetos. Projetos dos quais você é proprietário ou tem permissões de visualização ou edição.
- Compartilhado comigo. Projetos que não são seus, mas 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. Os ícones ao lado do nome do projeto indicam se ele é um projeto independente ou um projeto vinculado.
Ver detalhes do projeto
Cada projeto inclui uma visualização para mostrar detalhes do desenvolvedor sobre ele. Para ver os detalhes de um projeto, clique na linha da lista de projetos.
A visualização de detalhes do projeto mostra dados e gráficos de taxa de erros, execuções e usuários sobre o projeto, bem como os escopos OAuth solicitados de qualquer usuário do 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. 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". Consulte Tipos de execução para mais informações sobre como um projeto pode ser executado.
- Usuários. O número de contas de usuário únicas que executaram o projeto uma ou mais vezes durante o período especificado. Os 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 , precedendo os dados e gráficos. Selecione a guia para ver os dados associados a essa implantação. A seleção de 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.
Os projetos publicados como complementos não aparecem como implantados no painel do Apps Script.
Monitorar projetos
Marque os projetos com uma estrela. Ao marcar projetos com uma estrela, você também pode monitorar estatísticas e gráficos agregados de uso e taxa de erros.
Para marcar um projeto com uma estrela, à direita de uma linha de projeto, clique em Mais > Adicionar estrela. Você também pode marcar um projeto com uma estrela clicando em Mais ao visualizar os detalhes do projeto.
Na navegação à esquerda, selecione Projetos marcados com estrela para ver os projetos que você marcou. Clique no placar de taxa de erros, execuções ou usuários na parte de cima da página para ver os gráficos associados de 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
Use o painel do Apps Script para visualizar e gerenciar execuções individuais de funções de projeto do Apps Script. Para encontrar um registro completo de execuções recentes, selecione Minhas execuções na navegação à esquerda.
O painel Minhas execuções mostra um registro de todas as execuções anteriores e em execução de projetos dos quais você é proprietário, editor ou visualizador. Essa lista também pode incluir execuções de funções em projetos aos quais você não tem acesso, se elas 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 chamadas durante essa execução.
Controle 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 Hora 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 há nome nessa coluna se você não tiver acesso ao projeto de script correspondente da execução, mas ele foi 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 foi originada de uma invocação da API Apps Script.
- Acionada por tempo. A execução foi causada por um evento de tempo.
- Gatilho. A execução foi originada de uma fonte de gatilho.
- Webapp. A execução foi originada de um app da Web implantado.
- Editor. A execução foi originada do 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 "Em execução". 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á uma opção para a API Apps Script. Isso permite conceder acesso à API aos seus projetos de script.
Para acessar essa opçã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. O acesso aos seus projetos de script é desativado por padrão como uma precaução de segurança. Depois de conceder acesso, qualquer aplicativo de terceiros autorizado poderá usar a API para modificar seus scripts e implantações. Revogue esse acesso no painel Configurações a qualquer momento.
Encontre mais informações no guia de acesso à API Apps Script.