Перенесите приложение Google Chat

Если вы объедините организации Google Workspace, вам может потребоваться перенести приложение Chat, чтобы оно продолжало работать.

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

После того как вы определите, что вам необходимо перенести приложение Chat, выполните следующий трехэтапный процесс:

1. Настройте среду для своего приложения Chat, создав проект Google Cloud в объединенной организации, включив API и, возможно, настроив экран согласия OAuth 2.0.
2. Повторно разверните приложение Chat из нового облачного проекта.
3. Добавьте воссозданное приложение Chat в разделы или беседы Chat и отключите исходное приложение Chat.

Создайте облачный проект в объединенной организации и включите API.

Создание нового облачного проекта и включение API для приложения Chat в объединенной организации Google Workspace гарантирует, что пользователи и группы, которым вы разрешите доступ к приложению Chat, смогут делать это без ошибок.

Создать облачный проект

Включить API

Во всех приложениях чата должен быть включен Google Chat API. В зависимости от того, как построено ваше приложение чата, вам может потребоваться включить другие API. Например, если вы создали приложение чата с помощью Google Cloud Functions , включите Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, API реестра артефактов и Cloud Run API. Чтобы обеспечить работу перенесенного приложения, рекомендуется включить в новом проекте Cloud те же API, которые были включены в старом проекте Cloud.

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

Настройка экрана согласия OAuth

Возможно, вам потребуется настроить экран согласия OAuth для вашего облачного проекта. Если вы ранее использовали для авторизации OAuth 2.0, используйте те же области авторизации доступа.

1. В консоли Google Cloud выберите menu > API и службы > Экран согласия OAuth .

   Перейдите на экран согласия OAuth.

2. Выберите тип пользователя для вашего приложения, затем нажмите «Создать» .
3. Заполните форму регистрации приложения, затем нажмите « Сохранить и продолжить» .

4. Если вы создаете приложение для использования за пределами вашей организации Google Workspace, нажмите « Добавить или удалить области» . Мы рекомендуем следующие рекомендации при выборе областей:

   • Выберите области, обеспечивающие минимальный уровень доступа, необходимый вашему приложению. Список доступных областей см. в разделе «Области OAuth 2.0 для API Google» .
   • Просмотрите области, перечисленные в каждом из трех разделов: неконфиденциальные области, конфиденциальные области и области с ограниченным доступом. Для любых областей, перечисленных в разделах «Ваши конфиденциальные области» или «Ваши ограниченные области», попытайтесь определить альтернативные неконфиденциальные области, чтобы избежать ненужных дополнительных проверок.
   • Некоторые области требуют дополнительных проверок со стороны Google. Для приложений, используемых только внутри вашей организации Google Workspace, области действия не отображаются на экране согласия, а использование ограниченных или конфиденциальных областей не требует дальнейшей проверки со стороны Google. Дополнительные сведения см. в разделе Категории областей .
5. После выбора областей, необходимых вашему приложению, нажмите « Сохранить и продолжить» .
6. Если в качестве типа пользователя вы выбрали Внешний , добавьте тестовых пользователей:
   1. В разделе «Тестовые пользователи» нажмите «Добавить пользователей» .
   2. Введите свой адрес электронной почты и адрес других авторизованных тестовых пользователей, затем нажмите «Сохранить и продолжить» .
7. Просмотрите сводку регистрации приложения. Чтобы внести изменения, нажмите «Изменить» . Если регистрация приложения выглядит нормально, нажмите «Вернуться на панель управления» .

Повторно разверните приложение Chat в новом облачном проекте.

В зависимости от того, создано ли ваше приложение Chat с помощью Apps Script, AppSheet или другого типа подключения, например Python или Java, повторное развертывание приложения Chat немного отличается. В любом случае вам не нужно заново создавать весь код, но вам необходимо внести некоторые изменения.

Перенос логики приложения Chat

В зависимости от архитектуры вашего приложения Chat вам может потребоваться перенести другие службы в новый облачный проект:

• Для HTTP-приложений вам также необходимо перенести остальную часть логики приложения, созданную с помощью Cloud Functions, Cloud Run или App Engine.
• Для приложений диалогового чата, использующих естественный язык, вам также необходимо перенести агенты Dialogflow.
• Для приложений чата, созданных за брандмауэром, вам также необходимо перенести темы Pub/Sub.

Настройте приложение Chat в новом облачном проекте.

Чтобы повторно развернуть приложение Chat, созданное на таком языке, как Python или Java, настройте приложение Chat в новом облачном проекте.

1. В консоли Google Cloud найдите «Google Chat API» и нажмите «Google Chat API» , затем нажмите « Управление» .

   Перейти к API чата

2. Перейдите на вкладку «Конфигурация» и введите следующую необходимую информацию:

   • Имя приложения : имя, которое люди используют при взаимодействии с вашим приложением чата.
   • URL-адрес аватара : URL-адрес HTTPS, указывающий на квадратное графическое изображение (например, PNG или JPEG) размером не менее 128x128, которое отображается в качестве аватара для вашего приложения чата.
   • Описание : описание предназначения приложения Chat, которое отображается под названием вашего приложения Chat.

3. Чтобы включить интерактивные функции, щелкните переключатель «Включить интерактивные функции» , который позволит пользователям взаимодействовать с вашим приложением чата, и используйте следующую таблицу для завершения настройки:

   Поле	Описание
   Функциональность	Набор полей, определяющих, как приложение Chat может взаимодействовать с пользователями: Получайте сообщения 1:1 . Пользователи могут находить приложение Chat и отправлять ему сообщения прямо в Google Chat. Присоединяйтесь к группам и групповым беседам . Пользователи могут добавлять приложение Chat в группы и групповые беседы.
   Настройки соединения	Конечная точка для приложения Chat, которая может быть одной из следующих: URL-адрес приложения : конечная точка HTTPS, на которой размещается реализация приложения Chat. Проект Apps Script : идентификатор развертывания проекта Apps Script, реализующего приложение Chat. Название темы Cloud Pub/Sub : тема Pub/Sub, на которую приложение Chat подписывается в качестве конечной точки. Dialogflow : регистрирует приложение Chat с интеграцией Dialogflow. Дополнительные сведения см. в разделе Создание приложения Google Chat Dialogflow, понимающего естественный язык .
   Слэш-команды	Команды, которые могут быть доступны пользователям в Google Chat. Позволяет пользователям видеть основные действия вашего приложения Chat в Google Chat и выбирать конкретное действие, с которым они хотят взаимодействовать. Дополнительные сведения см. в разделе «Реагирование на команды с косой чертой в приложении чата» .
   Предварительный просмотр ссылок	Шаблоны URL-адресов, которые приложение Chat распознает и предоставляет дополнительный контент, когда пользователи отправляют ссылки. Дополнительную информацию см. в разделе Ссылки для предварительного просмотра .
   Видимость	До 5 человек или одна или несколько групп Google, которые могут просматривать и устанавливать ваше приложение Chat. Используйте это поле, чтобы протестировать приложение Chat или поделиться им со своей командой. Дополнительную информацию см. в разделе Настройки видимости и публикации для вашего приложения Chat .

4. Чтобы регистрировать ошибки в Cloud Logging каждый раз, когда приложение Chat возвращает ошибку, установите флажок Записывать ошибки в журнал . Дополнительные сведения см. в разделе Журналы ошибок запросов для приложений чата .

5. Нажмите Сохранить . Когда вы сохраняете конфигурацию приложения Chat, оно становится доступным указанным пользователям в вашей организации Google Workspace.

Повторное развертывание приложения Apps Script Chat

Чтобы повторно развернуть приложение Chat, созданное с помощью Apps Script, измените номер проекта Cloud, с которым связан проект Apps Script, на номер проекта, который принадлежит вашему новому облачному проекту. Затем скопируйте идентификатор развертывания Apps Script и вставьте его на страницу конфигурации приложения Chat в консоли Google Cloud.

Скопируйте номер вашего облачного проекта

1. В консоли Google Cloud выберите menu > IAM и администрирование > Настройки .

   Перейдите в IAM и настройки администратора.

2. В поле Номер проекта скопируйте значение.

Установите номер проекта Google Cloud в проекте Apps Script.

1. Перейдите в скрипт приложений.

   Перейти к скрипту приложений

2. В проекте Apps Script приложения Chat нажмите settings проекта» .

3. В разделе «Проект Google Cloud Platform (GCP)» нажмите « Изменить проект» .

4. В поле «Номер проекта GCP» вставьте номер проекта Google Cloud.

5. Нажмите Установить проект .

Скопируйте идентификатор развертывания проекта Apps Script.

1. В правом верхнем углу App Script нажмите «Развертывание» > «Управление развертываниями» .
2. В разделе «Идентификатор развертывания» нажмите « Копировать» .
3. Нажмите Готово .

Перенастройте и повторно разверните приложение Chat

1. В консоли Google Cloud найдите «Google Chat API» и нажмите «Google Chat API» , затем нажмите « Управление» .

   Перейти к API чата

2. Перейдите на вкладку «Конфигурация» и введите следующую необходимую информацию:

   • Имя приложения : имя, которое люди используют при взаимодействии с вашим приложением чата.
   • URL-адрес аватара : URL-адрес HTTPS, указывающий на квадратное графическое изображение (например, PNG или JPEG) размером не менее 128x128, которое отображается в качестве аватара для вашего приложения чата.
   • Описание : описание предполагаемой цели приложения Chat, которое отображается под названием вашего приложения Chat.

3. Чтобы включить интерактивные функции, нажмите переключатель «Включить интерактивные функции» , который позволит пользователям взаимодействовать с вашим приложением чата:

4. В разделе «Настройки подключения» выберите «Проект Apps Script» .

5. В поле «Идентификатор развертывания» вставьте ранее скопированный идентификатор развертывания.

6. Чтобы завершить остальную настройку, см. таблицу в разделе «Настройка приложения Chat в новом облачном проекте».

7. Нажмите Сохранить .

Повторное развертывание приложения AppSheet Chat

Чтобы повторно развернуть приложение Chat, созданное с помощью AppSheet, в новом проекте Cloud, скопируйте его в новый проект Cloud .

Обновите учетную запись службы

Если ваше приложение Chat аутентифицируется как приложение и использует учетную запись службы для вызовов API Google, обновите данные учетной записи службы приложения Chat. Дополнительные сведения см. в разделе Аутентификация в приложении чата .

Поделитесь своим приложением чата

Прежде чем ваше приложение Chat станет доступным для пользователей в новой организации, вашему администратору, возможно, придется вручную разрешить доступ к приложению Chat. Дополнительную информацию см. в разделе Как администраторы Google Workspace устанавливают приложения Chat .

Перейдите на новое приложение Чат

Теперь, когда приложение Chat перенесено в новую организацию, пришло время опубликовать его. Добавьте его в разделы чата или в личные сообщения, а затем удалите из них старое приложение чата, чтобы люди отправляли сообщения только в перенесенное приложение чата.

Добавьте новое приложение Chat в разделы Chat

1. Зайдите в чат.

   Перейти в чат

2. Нажмите на прямое сообщение или пробел.

3. Нажмите раскрывающийся список рядом с именем пространства или человека, а затем выберите Приложения и интеграции .

4. Нажмите «Добавить приложения» .

5. Введите имя приложения, выберите приложение из списка и нажмите «Добавить» .

6. Повторите эти шаги для каждого пространства или прямого сообщения, в которое вы хотите добавить приложение чата.

Удалите старое приложение Chat из чат-групп.

1. Зайдите в чат.

   Перейти в чат

2. Нажмите на прямое сообщение или пробел.

3. Нажмите раскрывающийся список рядом с именем пространства или человека, а затем выберите Приложения и интеграции .

4. Рядом со старым, неперенесенным приложением Chat нажмите «Дополнительные параметры more_vert , а затем нажмите « Удалить из пространства» .

5. Повторите эти шаги для каждого пространства или личного сообщения, из которого вы хотите удалить старое приложение чата.

Отключите старое приложение Чат

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

похожие темы

• Публикация приложений