Управление проектами
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В этом разделе представлен обзор методов API Apps Script, которые можно использовать для создания, чтения, изменения и мониторинга проектов Apps Script. На странице примеров управления проектами представлены примеры запросов на управление API. В справочной документации по каждому методу приведены подробные сведения о реализации.
| Обзор методов API |
|---|
| Создавать проекты | проекты.создать Результаты : создание базового пустого проекта без файлов проекта и манифеста проекта по умолчанию. Параметры : вы можете указать название проекта. Вы также можете создать привязанный сценарий , указав идентификатор Google Drive файла Google Docs, Google Sheets, Google Forms или Slides, который будет родительским для сценария. |
| Чтение метаданных проекта | проекты.получить Результаты : Возвращает объект Project , представляющий метаданные проекта. Эти данные включают название проекта, идентификатор скрипта, имя создателя, время создания и другие сведения. |
| Прочитать содержание проекта | проекты.getContent Результаты : Возвращает массив объектов File , по одному для каждого файла кода и HTML-файла в проекте. Список также включает манифест проекта в виде JSON-файла. Объекты File содержат исходное содержимое файла ( File.source ) и другие метаданные, например, список функций в файле ( File.functionSet ). Параметры : вы можете указать, какую версию контента следует извлечь, с помощью параметра запроса. |
| Обновление содержания проекта | проекты.updateContent Результаты : Изменяет содержимое файла в проекте скрипта. Вы предоставляете новое содержимое в виде массива объектов File . Один из этих объектов File должен иметь тип JSON и представлять новый манифест проекта скрипта. Новое содержимое сохраняется в виде HEAD-версии проекта. Оно используется при выполнении скрипта в качестве триггера, в редакторе скриптов, в режиме предварительного просмотра дополнения, а также в качестве веб-приложения или API Apps Script в режиме разработки. Примечание : при обновлении содержимого проекта скрипта общепринятой практикой является сначала выдача запроса projects.getContent для извлечения массива существующих File File, выполнение действий с этими объектами, а затем использование File в качестве входных данных для запроса projects.updateContent . Внимание: новый контент заменяет все существующие файлы в проекте скрипта. Файлы, не обновлённые по запросу, удаляются. |
| Чтение показателей проекта | проекты.getMetrics Результаты : просмотр определенных метрик проекта. Эти метрики включают количество пользователей, общее количество выполнений, общее количество ошибок выполнения и другие сведения. Используйте MetricType для указания запрашиваемой информации. Параметры : Ограничьте результаты конкретными развертываниями или функциями скрипта с помощью MetricsFilter . Вы также можете определить конкретный интервал метрик с помощью MetricsIntervalConfig . |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 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,["# Managing Projects\n\nThis 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). |"]]
