Развертывание проекта Google Apps Script — это версия скрипта, доступная для использования в качестве веб-приложения, дополнения Google Workspace или исполняемого файла API. Создавая и управляя развертываниями, вы можете дорабатывать свой код, отслеживать изменения и контролировать доступ пользователей к той или иной версии кода.
Существует два типа развертывания:
- Предварительные развертывания , которые всегда синхронизируются с текущим кодом проекта.
- Версионированные развертывания , которые подключаются к определенной версии проекта.
Развертывание голов
Текущая версия проекта (head deployment) — это текущий код проекта. При создании проекта Apps Script система автоматически создает для этого проекта текущую версию проекта.
Основная версия развертывания всегда синхронизируется с последним сохраненным кодом. Например, если вы создаете версионированное развертывание, а затем изменяете свой код, основная версия развертывания отражает эти изменения, в то время как версионированное развертывание остается неизменным.
Используйте развертывания из головной директории для тестирования кода. Не используйте развертывания из головной директории для публичного использования.
Для каждого проекта Apps Script существует только одно основное развертывание (head deployment). Для использования основного развертывания необходимо иметь как минимум права на чтение проекта Script.
Версионированные развертывания
Версионное развертывание обеспечивает доступ к конкретной версии кода проекта. Это позволяет пользователям продолжать использовать работающую версию, пока вы вносите изменения и улучшения в код.
При публикации приложения для публичного использования всегда используйте версионированное развертывание. Одновременно может быть несколько активных версионированных развертываний.
Важно : Вы не можете передать права собственности на версионированные развертывания. Если вы передаете права собственности на проект скрипта, владелец существующих версионированных развертываний не меняется. Если администратор удаляет учетную запись владельца развертывания, в его развертываниях могут возникать ошибки скриптов.
Создайте развертывание с версионированием.
Для развертывания версии дополнения, дополнения для редактора, приложения чата или исполняемого файла API необходимо сначала изменить ассоциацию проекта Google Cloud в Apps Script с проекта по умолчанию на стандартный проект .
Для создания версионированного развертывания:
- Откройте проект Apps Script. <<../_common/snippets/create-new-deployment.md>>
Каждое новое развертывание можно предоставить в качестве библиотеки. Если вы предоставите скрипт в качестве библиотеки, описание развертывания будет видно пользователям библиотеки.
Просмотр версионированных развертываний
Чтобы просмотреть развертывания проекта Apps Script, вверху нажмите «Развернуть» > «Управление развертываниями» .
Чтобы просмотреть код конкретной версии, перейдите в раздел «Просмотр предыдущей версии» .
Редактирование развертывания с версионированием
Вы можете редактировать версионированное развертывание, чтобы изменить его описание или версию. Чтобы отредактировать развертывание:
- Откройте проект Apps Script.
- Нажмите «Развернуть» > «Управление развертываниями» .
- Выберите активное развертывание и нажмите «Редактировать .
- Внесите изменения и нажмите «Развернуть» .
Чтобы отредактировать заархивированное развертывание, повторно разверните его, а затем выполните описанные выше шаги.
Чтобы внести изменения в код проекта, создайте новую версию и отредактируйте развертывание, чтобы использовать её. Развертывание автоматически будет использовать новую версию для всех пользователей.
Найдите идентификатор развертывания.
Каждому развертыванию присваивается строковый идентификатор. Чтобы найти этот идентификатор:
- Откройте проект Apps Script.
- В правом верхнем углу нажмите «Развернуть» > «Управление развертываниями» .
- Выберите активное развертывание, чтобы узнать его идентификатор.
Идентификаторы развертывания отображаются только для активных развертываний.
Протестируйте развертывание.
Метод тестирования развертывания зависит от типа разрабатываемого вами приложения.
Дополнение Google Workspace
Для проверки развертывания дополнения см. раздел «Тестирование дополнений» .
Дополнение редактора
Для проверки развертывания дополнения к редактору см. раздел «Тестирование дополнения к редактору» .
Веб-приложение
Для тестирования развертывания веб-приложения см. раздел «Тестирование развертывания веб-приложения» .
Приложение Google Чат
Для тестирования развертывания приложения чата создайте версионированное развертывание скрипта, чтобы получить доступ к его идентификатору развертывания.
Получив идентификатор развертывания, укажите его в конфигурации Chat API и выполните действия для тестирования интерактивных функций .
Исполняемый файл API
Для тестирования развертывания исполняемого файла API создайте версионированное развертывание . После создания развертывания выполните следующие шаги:
- В правом верхнем углу проекта Apps Script нажмите «Развернуть» > «Тестовые развертывания» .
- Рядом с кнопкой «Выберите тип» нажмите
> Исполняемый файл API . - Скопируйте и используйте URL-адрес для тестирования развертывания исполняемого файла вашего API.
Архивирование версионированного развертывания
Удалить версионированные развертывания нельзя. Вместо этого их можно заархивировать.
Для архивирования развертывания с версионированием:
- Откройте проект Apps Script.
- Нажмите «Развернуть» > «Управление развертываниями» .
- Выберите развертывание и нажмите «Архивировать развертывания ».
Повторно развернуть заархивированное развертывание
- Откройте проект Apps Script.
- В правом верхнем углу нажмите «Развернуть» > «Управление развертываниями» .
- В разделе «Архивированные» выберите развертывание и нажмите > « Развернуть» .