Панель управления Apps Script позволяет управлять проектами Apps Script и отслеживать их. Вы можете использовать панель управления для выполнения следующих действий:
- Просматривайте и ищите существующие проекты Apps Script, включая привязанные скрипты, прикрепленные к документам Google Workspace.
- Создавайте новые проекты.
- Просматривайте сведения о своих проектах, например, используемые области OAuth .
- Контролируйте состояние и использование ваших скриптовых проектов.
- Просматривайте журналы выполнения ваших проектов и других проектов, запущенных с использованием учетных данных вашей учетной записи.
- Включите или выключите API скриптов приложений , чтобы разрешить или запретить приложениям использовать API для взаимодействия с вашими проектами скриптов.
Просмотр и поиск проектов
На панели управления Apps Script представлен список всех проектов скриптов, которые можно просматривать или редактировать. В левой части панели управления эти проекты разделены на следующие категории:
- Избранные проекты . Проекты, которые вы отслеживаете .
- Мои проекты . Проекты, владельцем которых вы являетесь.
- Все проекты . Проекты, которыми вы владеете или для которых у вас есть разрешение на просмотр или редактирование.
- Совместно со мной . Проекты, которые вам не принадлежат, но которыми с вами поделились.
- Корзина . Проекты, которые вы удалили из Google Диска.
В списках проектов отображаются название проекта, владелец и дата последнего изменения. Значки рядом с названием проекта указывают, является ли проект автономным или связанным .
Посмотреть детали проекта
Каждый проект включает в себя представление для просмотра информации о разработчике. Чтобы просмотреть информацию о проекте, щелкните строку в списке проектов.
В окне сведений о проекте отображаются данные о частоте ошибок , выполнениях и пользователях , а также графики, касающиеся проекта, а также области действия OAuth , запрошенные у всех конечных пользователей, использующих проект. Метрики данных определяются следующим образом:
- Коэффициент ошибок . Процент выполнений, которые не удалось выполнить из-за неперехваченных исключений. Рассчитывается делением числа неудачных выполнений на общее количество выполнений за определенный период времени.
- Исполнения . Количество запусков проекта. Подробнее о способах запуска проекта см. в разделе « Типы исполнения ».
- Пользователи . Количество уникальных пользователей (учётных записей), которые запускали проект один или несколько раз за указанный период времени. Анонимные пользователи не отслеживаются и, следовательно, не отражаются в статистике пользователей или графиках.
Каждое развёртывание вашего проекта отображается в виде вкладки на странице «Сведения о проекте» над данными и графиками. Вы можете выбрать вкладку, чтобы просмотреть соответствующие данные для этого развёртывания. При выборе варианта «ВСЕ» отображаются агрегированные данные по всем развёртываниям проекта и по выполнениям, выполненным разработчиками, которые запускают проект из редактора кода Apps Script.
Мониторинг проектов
У вас может быть доступ к значительно большему количеству проектов Apps Script, чем вы используете или управляете регулярно. Чтобы добавить проекты в закладки для быстрого доступа, вы можете добавить их в звёздочки. Добавление звёздочек в звёздочки также позволяет отслеживать общую статистику использования и частоту ошибок, а также строить графики по этим проектам.
Чтобы добавить проект в звёздочку, справа от строки проекта нажмите «Подробнее > «Добавить звёздочку» . Вы также можете добавить проект в звёздочку, нажав «Подробнее при просмотре сведений о проекте .
В левой панели навигации вы можете выбрать «Избранные проекты» , чтобы увидеть проекты, добавленные в закладки. Нажмите на таблицу показателей «Процент ошибок» , «Выполнения» или «Пользователи» в верхней части страницы, чтобы увидеть соответствующие графики для всех ваших избранных проектов за последние 7 дней.
Вы можете удалить звезду из проекта, нажав кнопку Подробнее в строке проекта и выбрав Удалить звезду .
Управление казнями
Панель управления Apps Script позволяет просматривать и управлять отдельными выполнениями функций проекта Apps Script. Полный журнал последних выполнений можно найти, выбрав пункт «Мои выполнения» в левой панели навигации.
Панель «Мои выполнения» по умолчанию отображает журнал всех предыдущих и текущих выполнений проектов, владельцем, редактором или читателем которых вы являетесь. Этот список также может включать в себя выполнение функций в проектах, к которым у вас нет доступа, если они выполняются от вашего имени (например, установленные и запущенные вами надстройки). В списке выполнений отображается только начальная функция, вызываемая для запуска выполнения. Он не отображает все функции, вызванные во время этого выполнения.
Вы можете управлять типом выполнения, отображаемым в журнале, с помощью фильтров в верхней части представления. Каждая строка журнала соответствует одному выполнению. Столбцы «Время начала» , «Длительность » и «Статус» содержат соответствующую информацию об этом выполнении.
В столбце «Функция» отображается имя функции, инициировавшей выполнение. Имя в этом столбце отсутствует, если у вас нет доступа к соответствующему проекту скрипта выполнения, но он был запущен от вашего имени.
Столбец «Тип» показывает, что инициировало выполнение. Возможные значения:
- Add On . Казнь произошла из-за дополнения.
- API выполнения . Выполнение было инициировано вызовом API Apps Script.
- Причиной казни стало событие, обусловленное временем .
- Триггер . Исполнение инициировано триггерным источником.
- Веб-приложение . Выполнение было инициировано из развернутого веб-приложения.
- Редактор . Выполнение инициировано редактором Apps Script.
Прекратить казни
Длительные выполнения, которые в данный момент выполняются, обозначены статусом «Выполняется». Чтобы остановить эти выполнения, справа от строки проекта нажмите « > «Завершить» .
Настройки
Вы можете настроить параметры панели инструментов, выбрав «Настройки» в левой навигационной панели.
На панели настроек есть переключатель API скриптов приложений . Он позволяет предоставить API доступ к вашим проектам скриптов .
Чтобы получить доступ к этому переключателю, нажмите на метку API скриптов Google Apps на панели настроек . Откроется новая панель с текстом предупреждения и переключателем. Доступ к вашим проектам скриптов по умолчанию отключен в целях безопасности. После предоставления доступа любое стороннее приложение, которому вы дадите разрешение, сможет использовать API для изменения ваших скриптов и развертываний. Вы можете отозвать этот доступ на панели настроек в любое время.
Более подробную информацию можно найти в руководстве по доступу к API Apps Script .