Панель управления скриптами приложений

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

  • Просмотр и поиск существующих проектов Apps Script, включая связанные сценарии, прикрепленные кGoogle Workspace документы.
  • Создавайте новые проекты.
  • Просмотр сведений о ваших проектах, например об используемых им областях OAuth .
  • Отслеживайте работоспособность и использование ваших проектов сценариев.
  • Просматривайте журналы выполнения своих и других проектов, которые выполняются с использованием учетных данных вашей учетной записи.
  • Включите или отключите Apps Script API , чтобы разрешить или запретить приложениям использовать API для взаимодействия с вашими проектами сценариев.

Просмотр и поиск проектов

На панели инструментов Apps Script перечислены все проекты сценариев, которые вы можете просматривать или редактировать. Левая панель навигации делит эти проекты на следующие категории:

  • Избранные проекты . Проекты, которые вы контролируете .
  • Мои проекты . Проекты, владельцем которых вы являетесь.
  • Все проекты . Проекты, которыми вы владеете или для которых у вас есть разрешения на просмотр или редактирование.
  • Поделился со мной . Проекты, которыми вы не владеете, но которыми с вами поделились.
  • Мусор . Проекты, которые вы удалили с Google Диска.

В списках проектов отображаются имя проекта, владелец и дата последнего изменения. Значки рядом с именем проекта указывают, является ли проект автономным или связанным проектом.

Посмотреть детали проекта

Каждый проект включает представление, позволяющее просмотреть сведения о проекте для разработчиков. Чтобы просмотреть подробную информацию о проекте, щелкните строку в списке проектов.

В представлении сведений о проекте отображаются данные о частоте ошибок , выполнениях и пользователях , а также графики проекта, а также области OAuth, запрошенные у любого конечного пользователя, использующего проект. Метрики данных определяются следующим образом:

  • Уровень ошибок . Процент выполнения, которые не удалось выполнить из-за неперехваченных исключений. Он рассчитывается как количество неудачных выполнений, разделенное на общее количество выполнений за определенный период времени.
  • Казни . Сколько раз проект был «запущен» или выполнен. Дополнительные сведения о том, как можно запустить проект, см. в разделе Типы выполнения .
  • Пользователи . Количество уникальных пользователей (учетных записей), запустивших проект один или несколько раз за указанный период времени. Анонимные пользователи не отслеживаются и поэтому не отражаются в подсчете пользователей или графиках.

Каждое развертывание вашего проекта отображается в виде вкладки на странице сведений о проекте над данными и графиками; вы можете выбрать вкладку, чтобы просмотреть связанные данные для этого развертывания. При выборе «ВСЕ» отображаются совокупные данные для всех развертываний проекта и выполнения, выполненного разработчиками, запускающими проект из редактора кода Apps Script.

Мониторинг проектов

У вас может быть доступ к значительно большему количеству проектов Apps Script, чем вы используете или управляете на регулярной основе. Чтобы добавить проекты в закладки для быстрого доступа, вы можете пометить их. Пометка главных проектов также позволяет отслеживать совокупную статистику использования и частоту ошибок, а также графики по этим проектам.

Чтобы пометить проект, справа от строки проекта нажмите Еще > Добавить пометку . Вы также можете пометить проект, нажав «Еще при просмотре сведений о проекте .

В левой панели навигации вы можете выбрать «Избранные проекты», чтобы просмотреть проекты, добавленные в закладки. Нажмите на систему показателей «Доля ошибок» , «Выполнения» или «Пользователи » в верхней части страницы, чтобы просмотреть соответствующие графики для всех отмеченных вами проектов за последние 7 дней.

Вы можете удалить звездочку из проекта, нажав «Еще в строке проекта и выбрав «Удалить звезду» .

Управление казнями

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

На панели «Мои выполнения» по умолчанию отображается журнал всех предыдущих и текущих выполнений проектов, владельцем, редактором или просматривателем которых вы являетесь. Этот список также может включать выполнение функций в проектах, к которым у вас нет доступа, если они выполняются от вашего имени (например, надстройки, которые вы установили и запустили). В списке выполнения отображается только начальная функция, которая вызывается для начала выполнения. Он не показывает каждую функцию, которая была вызвана во время этого выполнения.

Вы можете контролировать, о каком типе выполнения сообщается в журнале, с помощью фильтров в верхней части представления. Каждая строка журнала представляет одно выполнение. В столбцах «Время начала» , «Продолжительность» и «Состояние» отображается соответствующая информация об этом выполнении.

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

В столбце «Тип» показано, что инициировало выполнение. Ценности включают в себя:

  • Добавить . Исполнение произошло из надстройки.
  • API выполнения . Выполнение произошло в результате вызова Apps Script API.
  • Управляемый временем . Казнь была вызвана временным событием.
  • Курок . Выполнение произошло из источника триггера.
  • Веб-приложение . Выполнение произошло из развернутого веб-приложения.
  • Редактор . Выполнение произошло из редактора Apps Script.

Прекратить выполнение

Длительные выполнения, которые в данный момент выполняются, обозначаются статусом «Выполняется». Чтобы остановить эти выполнения, справа от строки проекта нажмите «Еще > «Завершить» .

Настройки

Вы можете настроить параметры панели управления, выбрав «Настройки» на левой панели навигации.

На панели «Настройки» находится переключатель Apps Script API . Это позволит вам предоставить доступ API к вашим проектам сценариев .

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

Дополнительную информацию см. в руководстве по доступу к Apps Script API .