Обзор разработки приложений Google Chat для импорта пользовательских данных

Чтобы импортировать пользовательские данные из других платформ обмена сообщениями в Google Chat, вы можете создать приложение Chat и режим импорта пространства чата. В пространствах режима импорта приложения Chat могут импортировать существующие сообщения, вложения, реакции, членство и объекты пространств с других платформ в эквивалентные ресурсы REST . Пространства режима импорта можно использовать только в процессе импорта.

Зачем использовать пространства режима импорта

Пространства режима импорта обеспечивают удобство работы для конечных пользователей, которые переходят с других платформ обмена сообщениями на Google Chat. По сравнению с копированием исходных данных в обычные пространства использование пространств режима импорта имеет следующие преимущества:

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

Ресурсы Google Chat, поддерживаемые в пространствах режима импорта

Вы можете импортировать следующие ресурсы API Google Chat с пробелами режима импорта:

  • Сообщения
  • Вложения со следующими соображениями:
    • Вложения можно загружать в пространства режима импорта с помощью Google Chat API, однако мы настоятельно рекомендуем использовать Google Drive API для загрузки файлов и связывать URI файлов с соответствующими сообщениями в пространствах режима импорта, чтобы избежать превышения внутреннего ограничения Google Chat на загрузку вложений.
  • Реакции
  • Членство со следующими соображениями:

    • Историческое членство необходимо импортировать, когда пространство находится в режиме импорта. Вы не сможете импортировать историческое членство после того, как пространство завершит режим импорта.
    • Другие существующие членства на исходной платформе обмена сообщениями должны быть созданы после того, как пространство завершит режим импорта.
    • Участники должны быть пользователями в одном домене.
  • Пространства . Поддерживается только SpaceType.SPACE .

Сопоставление исходных данных с ресурсами Google Chat

При импорте данных из исходных платформ обмена сообщениями в Google Chat просмотрите поддерживаемые ресурсы, которые вы можете создать в Chat. Затем определите исходные объекты, которые вы хотите импортировать, и сопоставьте каждый из них с ресурсом Chat. После того, как вы запланировали сопоставления ресурсов, прочитайте сущности из исходной платформы обмена сообщениями и запишите их в пространства режима импорта.