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

Панель инструментов 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 :

Задать новый вопрос

Ошибки

Если вы определили, что причина проблемы связана с ошибкой в ​​самой панели управления, вы можете выполнить поиск в нашем отслеживании проблем, чтобы определить, является ли это известной проблемой. Если это так, вы можете пометить проблему (нажмите звездочку рядом с номером проблемы) — мы отдаем приоритет ошибкам, которые получают больше звезд. Вы также можете добавлять комментарии к существующим задачам, но делать это следует только в том случае, если вы добавляете контекст или дополнительную информацию о проблеме.

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

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

Имейте в виду, что проблемы могут быть относительно спокойными в течение некоторого времени. Это не означает, что мы никогда не исправим проблему; это просто означает, что в настоящее время обновлений нет.

Сообщить о новой ошибке

Отсутствующие функции

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

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

Запросы Запросить новую функцию