Managing Projects

Esta seção apresenta uma visão geral dos métodos da API Apps Script que podem ser usados para criar, ler, modificar e monitorar seus projetos do Apps Script. A página de exemplos do Gerenciamento de projetos mostra exemplos de solicitações de gerenciamento de API. A documentação de referência de cada método fornece detalhes de implementação.

Visão geral do método de API
Criar projetos

projects.create

Resultados: cria um projeto básico vazio sem arquivos e com um manifesto de projeto padrão.

Opções: forneça um título para o projeto. Também é possível criar um script vinculado fornecendo o ID do Google Drive de um arquivo dos Documentos, Planilhas, Formulários ou Apresentações Google para atuar como pai do script.

Ler metadados do projeto

projects.get

Resultados: recupera um objeto Project, que representa os metadados do projeto. Esses dados incluem o título do projeto, o ID do script, o usuário de criação, o horário da criação e outros detalhes.

Ler o conteúdo do projeto

projects.getContent

Resultados: retorna uma matriz de objetos File, um para cada código e arquivo HTML no projeto. A lista também inclui o manifesto do projeto como um arquivo JSON. Os objetos de arquivo contêm o conteúdo de origem do arquivo (File.source) e outros metadados, como uma lista de funções no arquivo (File.functionSet).

Opções: é possível especificar qual versão do conteúdo será recuperada com um parâmetro de consulta.

Atualizar o conteúdo do projeto

projects.updateContent

Resultados: altera o conteúdo do arquivo em um projeto de script. Forneça o novo conteúdo como uma matriz de objetos File. Um desses objetos File precisa ter o tipo JSON e representar o novo manifesto do projeto do projeto de script. O novo conteúdo é armazenado como a versão HEAD do projeto. Ele é usado quando o script é executado como um acionador, no editor de scripts, no modo de visualização de complementos, ou como um app da Web ou uma API Apps Script no modo de desenvolvimento.

Observação: ao atualizar o conteúdo do projeto de script, a prática comum é emitir primeiro uma solicitação projects.getContent para recuperar uma matriz dos Files atuais, buscar os objetos e usar Files como entrada para uma solicitação projects.updateContent.

Aviso:o novo conteúdo substitui todos os arquivos existentes no projeto de script. Os arquivos não atualizados pela solicitação são removidos.

Ler as métricas do projeto

projects.getMetrics

Resultados: leia determinadas métricas sobre um projeto. Essas métricas incluem o número de usuários, o número total de execuções, o número total de erros de execução e outros detalhes. Use um MetricType para especificar as informações que você está solicitando.

Opções: restrinja os resultados a implantações ou funções de script específicas usando um MetricsFilter. Também é possível definir um intervalo de métrica específico usando um MetricsIntervalConfig.