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