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