Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
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 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.
Resultados: crie 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, Planilhas, Formulários ou Apresentações Google para atuar como o pai do script.
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, o horário de criação e outros detalhes.
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.
Results: 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 prévia do complemento ou como um app da Web ou API Apps Script no modo de desenvolvimento.
Observação: ao atualizar o conteúdo do projeto de script, a prática comum é primeiro emitir uma solicitação projects.getContent para recuperar uma matriz dos Files atuais, fazer o que for necessário nesses 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 de script. Os arquivos não atualizados pela solicitação são removidos.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-04 UTC."],[[["\u003cp\u003eThis section outlines Apps Script API methods for managing Apps Script projects, including creating, reading, updating, and monitoring.\u003c/p\u003e\n"],["\u003cp\u003eYou can create new projects, retrieve project metadata and content, and update project files using these methods.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows you to access project metrics like user count, executions, and errors for analysis.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided links for detailed documentation and code samples on project management requests.\u003c/p\u003e\n"]]],[],null,["This section provides an overview of the Apps Script API methods\nyou can use to create, read, modify,\nand monitor your Apps Script projects. The\n[Project Management](/apps-script/api/samples/manage)\nsamples page shows examples of API management requests. The reference\ndocumentation for each method provides implementation details.\n\n| **API method overview** ||\n|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Create projects** | [projects.create](/apps-script/api/reference/rest/v1/projects/create) **Results** : Create a basic, empty project with no project files and a default [project manifest](/apps-script/concepts/manifests). **Options** : You can provide a project title. You can also create a [bound script](/apps-script/guides/bound) by providing the Google Drive ID of a Google Docs, Google Sheets, Google Forms, or Slides file to act as the script's parent. |\n| **Read project metadata** | [projects.get](/apps-script/api/reference/rest/v1/projects/get) **Results** : Retrieves a [`Project`](/apps-script/api/reference/rest/v1/projects#Project) object, which represents project metadata. This data includes the project title, script ID, creating user, creation time, and other details. |\n| **Read project content** | [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) **Results** : Returns an array of [`File`](/apps-script/api/reference/rest/v1/File) objects, one for each code and HTML file in the project. The list also includes the [project manifest](/apps-script/concepts/manifests) as a JSON file. File objects contain the source content of the file (`File.source`) and other metadata, such a list of functions in the file (`File.functionSet`). **Options** : You can specify which [version](/apps-script/guides/versions) of the content to retrieve with a query parameter. |\n| **Update project content** | [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) **Results** : Changes the file content in a script project. You provide the new content as an array of [`File`](/apps-script/api/reference/rest/v1/File) objects. One of these `File` objects must have JSON type and represent the script project's new [project manifest](/apps-script/concepts/manifests). The new content is stored as the HEAD version of the project. It is used when the script executes as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. **Note** : When updating script project content, common practice is to first issue a [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) request to retrieve an array of the existing `File`s, make the desire to those objects, then use the `File`s as input for a [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) request. **Warning:** The new content replaces all existing files in the script project. Files not updated by the request are removed. |\n| **Read project metrics** | [projects.getMetrics](/apps-script/api/reference/rest/v1/projects/getMetrics) **Results** : Read certain metrics about a project. These metrics include the number of users, the total number of executions, the total number of execution errors, and other details. Use a [MetricType](/apps-script/api/reference/rest/v1/projects/getMetrics#metrictype) to specify the information you are requesting. **Options** : Restrict the results to specific deployments or script functions using a [MetricsFilter](/apps-script/api/reference/rest/v1/projects/getMetrics#MetricsFilter). You can also define a specific metric interval using a [MetricsIntervalConfig](/api/reference/rest/v1/projects/getMetrics#metricsintervalconfig). |"]]
