Перенесите приложение 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, смогут делать это без ошибок.

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

Консоль Google Cloud

  1. В консоли Google Cloud выберите > IAM и администрирование > Создать проект .

    Перейти к созданию проекта

  2. В поле «Имя проекта » введите описательное имя вашего проекта.

    Необязательно: Чтобы изменить идентификатор проекта , нажмите «Изменить» . Идентификатор проекта нельзя изменить после его создания, поэтому выберите идентификатор, который соответствует вашим потребностям на протяжении всего срока действия проекта.

  3. В поле «Местоположение » нажмите «Обзор» , чтобы отобразить возможные местоположения для вашего проекта. Затем нажмите «Выбрать» .
  4. Нажмите Создать . Консоль Google Cloud перейдет на страницу панели инструментов, и ваш проект будет создан в течение нескольких минут.

интерфейс командной строки gcloud

В одной из следующих сред разработки получите доступ к Google Cloud CLI ( gcloud ):

  • Cloud Shell : чтобы использовать онлайн-терминал с уже настроенным интерфейсом командной строки gcloud, активируйте Cloud Shell.
    Активировать Cloud Shell
  • Локальная оболочка : чтобы использовать локальную среду разработки, установите и инициализируйте интерфейс командной строки gcloud.
    Чтобы создать облачный проект, используйте команду gcloud projects create :
    gcloud projects create PROJECT_ID
     Замените PROJECT_ID , указав идентификатор проекта, который вы хотите создать.

Включить 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, сделайте следующее:

Консоль Google Cloud

  1. В консоли Google Cloud выберите > Дополнительные продукты > Google Workspace > Библиотека продуктов .

    Перейти в библиотеку продуктов

  2. Щелкните API, который вы хотите включить.
  3. Нажмите Включить .
  4. Чтобы включить больше API, повторите эти шаги.

Google Cloud CLI

  1. Установите или откройте интерфейс командной строки (CLI) Google Cloud .

  2. Запустите команду services enable , указав, какую службу API включить.

    gcloud services enable API_SERVICE_ID

Настройте API чата

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

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

  1. В консоли Google Cloud выберите > 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, созданное на таком языке, как Python или Java, настройте приложение Chat в новом облачном проекте.

Чтобы настроить интерактивные функции, см. раздел Получение и ответ на действия пользователя .

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

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

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

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

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

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

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

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

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

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

  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 нажмите «Дополнительные параметры , а затем нажмите «Удалить из пространства» .

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

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

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