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