Тестирование и отладка дополнений Apps Script для Google Workspace

После публикации дополнения пользователи могут установить его через основное приложение или через Google Workspace Marketplace . Перед публикацией протестируйте дополнение в приложениях, которые оно расширяет.

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

Предварительные требования

  • Для работы с проектом скрипта необходимы права редактора.
  • Чтобы другие могли протестировать дополнение, предоставьте им доступ к редактору проекта. См. раздел «Сотрудничество с другими разработчиками» .
  • Пользователи, проводившие тестирование, должны принадлежать к тому же домену, что и владелец скрипта.

Установите неопубликованное дополнение.

Установите неопубликованные дополнения из диалогового окна «Развертывания» .

Для установки неопубликованного дополнения в целях тестирования выполните следующие действия:

  1. Откройте проект скрипта в редакторе Apps Script.
  2. Выберите Развертывание > Тестовые развертывания .
  3. Выберите «Установить» .
  4. Внизу выберите «Готово» .

Чтобы другие пользователи могли протестировать дополнение, предоставьте им доступ к проекту через их учетную запись (требуются права на редактирование). Затем попросите пользователей выполнить те же действия.

После установки дополнения оно сразу же становится доступно в приложениях-хостах, которые оно расширяет. Возможно, потребуется обновить вкладку приложения-хоста, прежде чем дополнение появится. Авторизуйте дополнение перед его использованием. Если ваш проект уже авторизован, используйте ScriptApp.invalidateAuth для аннулирования существующих авторизаций. Это позволит вам протестировать функцию детальной аутентификации OAuth .

Удалите неопубликованное дополнение.

Чтобы удалить неопубликованное дополнение, выполните следующие действия:

  1. Откройте проект скрипта в редакторе Apps Script.
  2. Выберите Развертывание > Тестовые развертывания .
  3. Выберите «Удалить» .
  4. Внизу выберите «Готово» .

Выполнив эти шаги, вы удалите развертывание, и дополнение больше не будет отображаться. Вы можете переустановить развертывание в любое время.

лучшие практики тестирования

При тестировании дополнения следуйте рекомендациям по передовой практике . Также выполните следующие действия:

  1. Протестируйте сценарии навигации по карточкам во всех приложениях-хостах, на которые распространяется действие дополнения. Проверьте поведение пользователя при перемещении между контекстами, а также между неконтекстными и контекстными карточками.

  2. Используйте примеры тестовых данных для оценки поведения вашего дополнения.

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

  4. Обрабатывайте ошибки корректно. Используйте карточки ошибок там, где это необходимо.

  5. Отслеживайте производительность дополнения. Если после изменения кода работа дополнения замедляется, возможно, потребуется переработать эту функцию.