Managing Projects

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

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

projects.create

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

Opções: você pode fornecer um título do projeto. Também é possível criar um script vinculado fornecendo o ID do Google Drive de um arquivo do Documentos, Planilhas, Formulários ou Apresentações Google para que ele seja o 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 que criou, 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: 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 acionador, no editor de script, no modo de visualização do complemento ou como um app da Web ou uma API do 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 existentes, fazer o desejo para esses objetos e usar os Files como entrada para uma solicitação projects.updateContent.

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

Ler as métricas do projeto

projects.getMetrics

Resultados: leia algumas 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 uma MetricsIntervalConfig.