Если вы объединяете организации Google Workspace, вам может потребоваться перенести приложение Chat, чтобы оно продолжило работать.
Перед переносом приложения Chat обратитесь к администратору вашей организации, чтобы узнать, влияют ли на него административные настройки. Изменение административных настроек может восстановить полную функциональность приложения Chat и сделать миграцию ненужной. Например, администратору Google Workspace может потребоваться добавить приложение Chat в разрешённый список или разрешить пользователям устанавливать приложения Chat. Подробнее см. в статье «Определение необходимости переноса приложений Google Chat после объединения организаций Google Workspace» .
После того как вы определили, что вам необходимо перенести приложение Chat, выполните следующую трехэтапную процедуру:
- Настройте среду для своего приложения Chat, создав проект Google Cloud в объединенной организации, включив API и, возможно, настроив экран согласия OAuth 2.0.
- Повторно разверните приложение чата из нового облачного проекта.
- Добавьте воссозданное приложение Chat в чат-пространства или беседы и отключите исходное приложение Chat.
Создайте облачный проект в объединенной организации и включите API
Создание нового облачного проекта и включение API для приложения Chat в объединенной организации Google Workspace гарантирует, что пользователи и группы, которым вы разрешите доступ к приложению Chat, смогут делать это без ошибок.
Создать облачный проект
Консоль Google Cloud
- В консоли Google Cloud перейдите в > IAM и администрирование > Создать проект .
- В поле «Название проекта» введите описательное название вашего проекта.
Необязательно: чтобы изменить идентификатор проекта , нажмите «Изменить» . Идентификатор проекта нельзя изменить после его создания, поэтому выберите идентификатор, который будет соответствовать вашим потребностям на протяжении всего жизненного цикла проекта.
- В поле «Местоположение» нажмите «Обзор» , чтобы отобразить возможные местоположения для вашего проекта. Затем нажмите « Выбрать» .
- Нажмите «Создать» . Консоль Google Cloud перейдет на страницу панели управления, и ваш проект будет создан в течение нескольких минут.
gcloud CLI
В одной из следующих сред разработки получите доступ к Google Cloud CLI ( gcloud ):
- Cloud Shell : чтобы использовать онлайн-терминал с уже настроенным интерфейсом командной строки gcloud, активируйте Cloud Shell.
Активировать Cloud Shell - Локальная оболочка : чтобы использовать локальную среду разработки, установите и инициализируйте gcloud CLI.
Чтобы создать облачный проект, используйте командуgcloud projects create:gcloud projects create PROJECT_ID
Включить API
Во всех приложениях Chat должен быть включён API Google Chat. В зависимости от того, как построено ваше приложение Chat, вам может потребоваться включить другие API. Например, если вы создали приложение Chat с помощью Google Cloud Functions , включите API Cloud Build, API Cloud Functions, API Pub/Sub, API Cloud Logging, API Artifact Registry и API Cloud Run. Для обеспечения работоспособности перенесённого приложения рекомендуется включить в новом проекте Cloud те же API, что и в старом.
Чтобы включить API, выполните следующие действия:
Консоль Google Cloud
- В консоли Google Cloud перейдите в > Дополнительные продукты > Google Workspace > Библиотека продуктов .
- Щелкните API, который вы хотите включить.
- Нажмите «Включить» .
- Чтобы включить больше API, повторите эти шаги.
Google Cloud CLI
- Установите или откройте интерфейс командной строки (CLI) Google Cloud .
Запустите команду
services enable, указав, какую службу API следует включить.gcloud services enable API_SERVICE_ID
Настройте API чата
В вашем новом облачном проекте необходимо использовать API чата, чтобы указать имя, описание и значок вашего приложения чата. Чтобы настроить эти параметры, см. раздел «Настройка API чата».
Настройте экран согласия OAuth
Возможно, потребуется настроить экран согласия OAuth для вашего облачного проекта. Если вы ранее использовали OAuth 2.0 для авторизации, используйте те же области доступа.
- В консоли Google Cloud перейдите в > > Брендинг .
- Если вы уже настроили , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение: пока не настроено , нажмите «Начать» :
- В разделе «Информация о приложении» в поле «Имя приложения» введите имя приложения .
- В поле Адрес электронной почты службы поддержки пользователей выберите адрес электронной почты службы поддержки, по которому пользователи смогут связаться с вами, если у них возникнут вопросы относительно их согласия.
- Нажмите «Далее» .
- В разделе Аудитория выберите тип пользователя для вашего приложения.
- Нажмите «Далее» .
- В разделе «Контактная информация» введите адрес электронной почты , на который вы можете получать уведомления о любых изменениях в вашем проекте.
- Нажмите «Далее» .
- В разделе Готово ознакомьтесь с Политикой обработки данных пользователей API служб Google и, если вы согласны, выберите Я согласен с Политикой обработки данных пользователей API служб Google .
- Нажмите «Продолжить» .
- Нажмите «Создать» .
- Если вы выбрали тип пользователя «Внешний» , добавьте тестовых пользователей:
- Нажмите Аудитория .
- В разделе Тестовые пользователи нажмите Добавить пользователей .
- Введите свой адрес электронной почты и адрес других авторизованных тестовых пользователей, затем нажмите кнопку «Сохранить» .
Если вы создаёте приложение для использования за пределами вашей организации Google Workspace, нажмите «Доступ к данным» > «Добавить или удалить области действия» . Мы рекомендуем следующие рекомендации по выбору областей действия:
- Выберите области действия, обеспечивающие минимальный уровень доступа, необходимый вашему приложению. Список доступных областей действия см. в разделе Области действия OAuth 2.0 для API Google .
- Проверьте области действия, перечисленные в каждом из трёх разделов: неконфиденциальные области действия, конфиденциальные области действия и области действия с ограничениями. Для всех областей действия, перечисленных в разделах «Ваши конфиденциальные области действия» или «Ваши ограниченные области действия», постарайтесь найти альтернативные неконфиденциальные области действия, чтобы избежать ненужных дополнительных проверок.
- Для некоторых областей действия требуется дополнительная проверка со стороны Google. Для приложений, используемых только внутри вашей организации Google Workspace, области действия не отображаются на экране согласия, а использование ограниченных или конфиденциальных областей действия не требует дополнительной проверки со стороны Google. Подробнее см. в разделе «Категории областей действия» .
- После выбора областей, необходимых вашему приложению, нажмите кнопку Сохранить .
Для получения дополнительной информации о настройке согласия OAuth см. раздел Начало работы с .
Повторно разверните приложение чата в новом облачном проекте.
Повторное развёртывание вашего чат-приложения может немного отличаться в зависимости от того, создано ли оно с помощью Apps Script, AppSheet или другого типа подключения, например, Python или Java. В любом случае вам не нужно переписывать весь код, но необходимо внести некоторые изменения.
Перенести логику приложения чата
В зависимости от архитектуры вашего чат-приложения вам может потребоваться перенести другие службы в новый облачный проект:
- Для HTTP-приложений вам также необходимо перенести остальную логику приложения, созданную с использованием Cloud Functions, Cloud Run или App Engine.
- Для приложений разговорного чата, использующих естественный язык, вам также необходимо перенести агенты Dialogflow.
- Для приложений чата, созданных за брандмауэром, вам также необходимо перенести темы Pub/Sub.
Настройте интерактивные функции в новом облачном проекте
Чтобы повторно развернуть приложение чата, созданное с использованием языка Python или Java, настройте приложение чата в новом облачном проекте.
Чтобы настроить интерактивные функции, см. раздел Получение и реагирование на взаимодействия с пользователем .
Повторное развертывание приложения Apps Script Chat
Чтобы повторно развернуть приложение Chat, созданное с помощью Apps Script, измените номер проекта Cloud, с которым связан проект Apps Script, на номер проекта, принадлежащего вашему новому проекту Cloud. Затем скопируйте идентификатор развертывания Apps Script и вставьте его на страницу конфигурации приложения Chat в консоли Google Cloud.
Скопируйте номер вашего облачного проекта
- В консоли Google Cloud перейдите в > IAM и администрирование > Настройки .
- В поле Номер проекта скопируйте значение.
Укажите номер вашего проекта Google Cloud в вашем проекте Apps Script.
Перейдите в раздел «Скрипт приложений».
В проекте скрипта приложений приложения «Чат» нажмите проекта .
В разделе «Проект Google Cloud Platform (GCP)» нажмите «Изменить проект» .
В поле Номер проекта GCP вставьте номер проекта Google Cloud.
Нажмите Установить проект .
Скопируйте идентификатор развертывания вашего проекта Apps Script.
- В правом верхнем углу Apps Script нажмите Развернуть > Управление развертываниями .
- В разделе «Идентификатор развертывания» нажмите «Копировать» .
- Нажмите Готово .
Перенастройте и повторно разверните приложение чата.
В консоли Google Cloud найдите «Google Chat API» и нажмите Google Chat API , затем нажмите Управление .
Откройте вкладку «Конфигурация» и введите следующую необходимую информацию:
- Имя приложения : имя, которое люди используют при взаимодействии с вашим приложением чата.
- URL-адрес аватара : URL-адрес HTTPS, указывающий на квадратное графическое изображение (например, PNG или JPEG) размером не менее 128x128, которое будет отображаться в качестве аватара для вашего приложения чата.
- Описание : Описание предполагаемого назначения приложения чата, которое отображается под названием вашего приложения чата.
Чтобы включить интерактивные функции, щелкните переключатель Включить интерактивные функции , которые позволят пользователям взаимодействовать с вашим приложением чата:
В разделе «Параметры подключения» выберите Проект скрипта приложений .
В поле «Идентификатор развертывания» вставьте скопированный ранее идентификатор развертывания.
Чтобы завершить остальную часть настройки, см. таблицу в разделе «Настройка приложения чата в новом проекте Cloud».
Нажмите «Сохранить» .
Повторное развертывание приложения AppSheet Chat
Чтобы повторно развернуть приложение чата, созданное с помощью AppSheet, в новом облачном проекте, скопируйте приложение в новый облачный проект .
Обновите учетную запись службы
Если ваше приложение Chat аутентифицируется как приложение и использует учётную запись службы для вызовов API Google, обновите данные учётной записи службы приложения Chat. Подробнее см. в разделе «Аутентификация как приложение Chat» .
Поделитесь своим приложением чата
Прежде чем ваше приложение Chat станет доступно пользователям в новой организации, администратору, возможно, придётся вручную разрешить к нему доступ. Подробнее см. в разделе «Настройка доступа для организаций Google Workspace» в документации Google Workspace Marketplace.
Перейдите на новое приложение Chat
Теперь, когда приложение Chat перенесено в новую организацию, пора сделать его общедоступным. Добавьте его в чат-группы или личные сообщения, а затем удалите из них старое приложение Chat, чтобы пользователи могли отправлять сообщения только через перенесённое приложение Chat.
Добавьте новое приложение «Чат» в чат-пространства
Перейти в чат.
Нажмите на прямое сообщение или пробел.
Нажмите на раскрывающийся список рядом с названием пространства или человека, а затем выберите Приложения и интеграции .
Нажмите Добавить приложения .
Введите название приложения, выберите приложение из списка и нажмите «Добавить» .
Повторите эти шаги для каждого пространства или прямого сообщения, к которому вы хотите добавить приложение Chat.
Удалить старое приложение чата из чат-пространств
Перейти в чат.
Нажмите на прямое сообщение или пробел.
Нажмите на раскрывающийся список рядом с названием пространства или человека, а затем выберите Приложения и интеграции .
Рядом со старым, не перенесенным приложением Chat нажмите Дополнительные параметры , а затем нажмите Удалить из пространства .
Повторите эти шаги для каждого пространства или личного сообщения, из которого вы хотите удалить старое приложение чата.
Отключите старое приложение чата
Чтобы запретить пользователям использовать старое приложение Chat и побудить их использовать новое приложение Chat, отключите старое приложение Chat и отмените его публикацию в Google Workspace Marketplace .