Панель управления 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. Полный журнал последних выполнений можно найти, выбрав «Мои выполнения» в левой навигационной панели.
На панели «Мои выполнения» отображается журнал всех предыдущих и текущих выполнений для проектов, владельцем, редактором или наблюдателем которых вы являетесь. Этот список также может включать выполнения функций в проектах, к которым у вас нет доступа, если они выполняются от вашего имени (например, дополнения, которые вы установили и запустили). Список выполнений показывает только начальную функцию, которая вызывается для запуска выполнения. Он не показывает все функции, вызываемые во время этого выполнения.
Управляйте типом выполнения, отображаемым в журнале, с помощью фильтров в верхней части окна. Каждая строка журнала представляет собой отдельное выполнение. Столбцы « Время начала» , «Длительность » и «Статус» отображают соответствующую информацию об этом выполнении.
The Function column shows the name of the function that initiated the execution. There is no name in this column if you don't have access to the execution's corresponding script project but it ran on your behalf.
В столбце «Тип» отображается причина выполнения. Доступные значения:
- Дополнение . Запуск был инициирован дополнением.
- API выполнения . Выполнение инициировалось вызовом API Apps Script.
- Выполнение было вызвано временным событием.
- Триггер . Выполнение инициировалось источником триггера.
- Веб-приложение . Выполнение осуществлялось из развернутого веб-приложения.
- Редактор . Выполнение инициировалось из редактора Apps Script.
Прекратить исполнение
Длительно выполняющиеся процессы, находящиеся в процессе выполнения, обозначаются статусом «Выполняется». Чтобы остановить эти процессы, справа от строки проекта нажмите « > «Завершить» .
Настройки
Настройте параметры панели управления, выбрав «Настройки» в левой навигационной панели.
В панели настроек есть переключатель для API Apps Script . Он позволяет предоставить API доступ к вашим проектам скриптов .
Чтобы активировать этот переключатель, щелкните по метке Google Apps Script API на панели настроек . Откроется новая панель с предупреждающим текстом и переключателем. Доступ к вашим скриптовым проектам по умолчанию отключен в целях безопасности. После предоставления доступа любое авторизованное вами стороннее приложение сможет использовать API для изменения ваших скриптов и развертываний. Вы можете отозвать этот доступ в панели настроек в любое время.
Более подробную информацию можно найти в руководстве по доступу к API Apps Script .