Введение

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

Этот API часто используется для:

  • Создавайте и управляйте проектами и развертываниями Apps Script.
  • Добавление или обновление функций в скриптовых проектах.
  • Выполнение функций Apps Script из других приложений.
  • Отслеживайте журналы выполнения скриптов и их статусы.

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

Для использования этого API в ваших приложениях необходимо включить его .

Чтобы разрешить другим приложениям управлять вашими скриптами, необходимо предоставить им доступ .

Обзор API

API Apps Script разделен на несколько ресурсов, каждый из которых имеет определенное назначение и набор запросов, которые вы можете отправлять. Эти ресурсы следующие:

  • projects — представление проекта скрипта. API предоставляет методы для создания, чтения, мониторинга и изменения проектов. Используйте этот ресурс для управления файлами скриптов и метаданными вашего проекта.
  • projects.deployments — представление развертывания скрипта. API предоставляет методы для создания, перечисления, обновления и удаления развертываний проектов скриптов. Используйте развертывания, чтобы сделать ваш скрипт доступным в качестве веб-приложения, дополнения или исполняемого файла.
  • projects.versions — Представление версии проекта скрипта. API предоставляет методы для создания и чтения версий проекта. Используйте версии для отслеживания различных итераций вашего проекта скрипта.
  • processes — представление выполнения функции скрипта. API предоставляет методы для перечисления существующих процессов и сбора информации о них, такой как тип и текущий статус. Используйте этот ресурс для мониторинга выполнения скриптов, инициированного с помощью метода scripts.run .
  • scripts — это конечная точка, предоставляющая методы для удаленного выполнения функций Apps Script. Используйте этот ресурс для запуска функций в вашем проекте скриптов из вашего приложения.