Gerenciar projetos

Esta seção apresenta uma visão geral dos métodos da API Google Apps Script que você pode usar para criar, ler, modificar e monitorar seus projetos do Google Apps Script. A página de exemplos de 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 e vazio sem arquivos de projeto e um manifesto do projeto padrão. Opções: você pode fornecer um título para o projeto. Você também pode criar um script vinculado fornecendo o ID do Google Drive de um arquivo dos Documentos Google, Planilhas Google, Formulários Google ou Apresentações Google para atuar como o elemento 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 criador, a hora de criação e outros detalhes.
Ler o conteúdo do projeto	projects.getContent Resultados: retorna uma matriz de objetos File, um para cada arquivo de código e 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: muda o conteúdo do arquivo em um projeto de script. Você fornece 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 gatilho, no editor de script, no modo de visualização do complemento do Google Workspace ou como um app da Web ou API Apps Script no modo de desenvolvimento. Observação: para atualizar o conteúdo do projeto de script, primeiro emita uma solicitação projects.getContent para recuperar uma matriz dos Files atuais, faça as mudanças pretendidas nesses objetos e use os 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 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 total de execuções, o 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.