Visão geral do desenvolvimento de apps do Google Chat para importar dados do usuário

Para importar dados do usuário de outras plataformas de mensagens para o Google Chat, crie um app do Chat e um espaço do Chat no modo de importação. Nos espaços do modo de importação, os apps do Chat podem importar mensagens, anexos, reações, associações e entidades de espaço de outras plataformas para recursos REST equivalentes. Só é possível usar espaços do modo de importação durante o processo de importação.

Por que usar espaços do modo de importação

Os espaços do modo de importação oferecem uma experiência melhor para os usuários finais que estão fazendo a transição de outras plataformas de mensagens para o Google Chat. Em comparação com a cópia de dados de origem para espaços comuns, o uso de espaços do modo de importação tem as seguintes vantagens:

  • Preservação de carimbos de data/hora de criação de recursos. É possível definir um tempo histórico para os tempos de criação de recursos de espaços e mensagens, permitindo que os apps do Chat retenham o contexto histórico durante a adoção do Google Chat pelo usuário. Para mais informações, consulte Importar dados para o Google Chat.
  • Os usuários finais não podem ver nem acessar os espaços no modo de importação. Para evitar a interferência do usuário em um espaço que está passando pela importação de dados ou evitar possíveis confusão do usuário como resultado da visualização de uma importação de dados em andamento, os espaços no modo de importação ficam ocultos dos usuários finais. Após a conclusão do modo de importação de um espaço, você pode adicionar usuários.
  • O Chat desativa as notificações durante o modo de importação para que os usuários possam evitar alertas desnecessários sobre a migração.

Recursos do Google Chat compatíveis com espaços do modo de importação

É possível importar os seguintes recursos da API Google Chat com espaços do modo de importação:

  • Mensagens
  • Anexos com as seguintes considerações:
    • É possível fazer upload de anexos para espaços do modo de importação com a API Google Chat. No entanto, recomendamos o uso da API Google Drive para fazer upload de arquivos e vincular os URIs dos arquivos às respectivas mensagens nos espaços do modo de importação, em vez de atingir o limite interno do Google Chat para upload de anexos.
  • Reações

  • Associações com as seguintes considerações:

    • As associações históricas precisam ser importadas quando um espaço estiver no modo de importação. Não vai ser possível importar as associações históricas depois que o espaço sair do modo de importação.
    • As outras associações atuais da plataforma de mensagens original vão precisar ser criadas depois que um espaço sair do modo de importação.
    • Os membros precisam ser usuários dentro do mesmo domínio.

  • Espaços. Apenas SpaceType.SPACE é aceito.

Mapear dados de origem para recursos do Google Chat

Ao importar dados de plataformas de mensagens de origem para o Google Chat, consulte os recursos compatíveis que podem ser criados no Chat. Em seguida, determine as entidades de origem que você quer importar e mapeie cada uma para um recurso do Chat. Depois de planejar os mapeamentos de recursos, leia as entidades da plataforma de mensagens de origem e grave-as nos espaços do modo de importação.