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

В этом разделе представлен обзор методов API Google Apps Script, которые можно использовать для создания, чтения, изменения и мониторинга ваших проектов Google Apps Script. На странице примеров управления проектами показаны примеры запросов к API. В справочной документации для каждого метода приведены подробные сведения о реализации.

Обзор методов API
Создавайте проекты

проекты.создать

Результаты : Создан базовый пустой проект без файлов проекта и с манифестом проекта по умолчанию.

Параметры : Вы можете указать название проекта. Вы также можете создать связанный скрипт , указав идентификатор файла Google Docs, Google Sheets, Google Forms или Google Slides в Google Диске, который будет выступать в качестве родительского файла для скрипта.

Прочитайте метаданные проекта

проекты.получить

Результаты : Извлекает объект Project , представляющий метаданные проекта. Эти данные включают название проекта, идентификатор скрипта, пользователя, создавшего проект, время создания и другие сведения.

Ознакомьтесь с содержанием проекта.

проекты.getContent

Результаты : Возвращает массив объектов File , по одному для каждого файла кода и HTML в проекте. Список также включает манифест проекта в формате JSON. Объекты File содержат исходный код файла ( File.source ) и другие метаданные, такие как список функций в файле ( File.functionSet ).

Параметры : Вы можете указать, какую версию контента следует получить, с помощью параметра запроса.

Обновить содержимое проекта

projects.updateContent

Результат : Изменяет содержимое файла в проекте скрипта. Новое содержимое предоставляется в виде массива объектов File . Один из этих объектов File должен иметь тип JSON и представлять новый манифест проекта скрипта. Новое содержимое сохраняется как HEAD-версия проекта. Оно используется при выполнении скрипта в качестве триггера, в редакторе скриптов, в режиме предварительного просмотра надстройки Google Workspace, а также в качестве веб-приложения или API Apps Script в режиме разработки.

Примечание : Чтобы обновить содержимое проекта скрипта, сначала отправьте запрос projects.getContent для получения массива существующих File , внесите необходимые изменения в эти объекты, а затем используйте File в качестве входных данных для запроса projects.updateContent .

Внимание: новое содержимое заменяет все существующие файлы в проекте скрипта. Файлы, не обновленные запросом, будут удалены.

Ознакомьтесь с показателями проекта.

проекты.getMetrics

Результаты : Получение определенных метрик проекта. Эти метрики включают количество пользователей, общее количество выполнений, общее количество ошибок выполнения и другие подробности. Используйте MetricType для указания запрашиваемой информации.

Параметры : Ограничьте результаты определенными развертываниями или функциями скриптов с помощью MetricsFilter . Вы также можете определить определенный интервал метрик с помощью MetricsIntervalConfig .