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