Управление проектами

В этом разделе представлен обзор методов 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 .