Autorizar apps do Google Chat a importar dados

Com a API Google Chat, os apps podem importar dados de outras plataformas de mensagens para o Google Chat usando espaços no modo de importação. Para mais informações, consulte Importar dados de mensagens de outro serviço para o Google Chat.

Para ler e gravar recursos em espaços no modo de importação, é necessário autenticar apps do Chat com uma conta de serviço. Conceda à conta de serviço o seguinte escopo de autorização da API Chat por um administrador: https://www.googleapis.com/auth/chat.import.

Somente administradores de domínio do Google Workspace podem conceder esse escopo do OAuth a contas de serviço por meio da delegação em todo o domínio. Todo domínio em que um app do Chat cria espaços no modo de importação precisa ter esse escopo do OAuth. Depois que a conta de serviço receber a delegação de autoridade em todo o domínio para esse escopo, os apps de chat poderão acessar os espaços do modo de importação personificando uma conta de usuário.

Em alguns casos, a conta de usuário para falsificação pode não estar mais disponível. Nesses casos, o app Chat pode usar as credenciais da conta de serviço como alternativa. Por exemplo, se você excluir uma conta de usuário que foi usada durante a criação da mensagem, o app Chat poderá usar as credenciais da própria conta de serviço para criar uma mensagem com o mesmo conteúdo. Os apps de chat podem acessar espaços do modo de importação como um app usando credenciais da conta de serviço com o seguinte escopo do OAuth: https://www.googleapis.com/auth/chat.bot.

Nenhum outro escopo da API Google Chat é necessário ao importar recursos para um espaço do modo de importação. Os apps de chat só podem importar conteúdo para os espaços do modo de importação criados por eles, e não para os espaços criados por outros apps.

A tabela a seguir lista os métodos de recurso que os apps do Chat podem chamar em espaços do modo de importação e o tipo de autenticação aceito:

Método de recurso

Suporte à representação de usuários

Credenciais da conta de serviço compatíveis

spaces.create

Sim

Não

spaces.get

Não

Sim

spaces.update

Sim

Não

spaces.delete

Sim

Não

spaces.completeImport

Sim

Não

spaces.messages.create

Sim

Sim

spaces.messages.delete

Sim

Sim

spaces.messages.get

Não

Sim

spaces.messages.list

Sim

Não

spaces.messages.update

Sim

Sim

spaces.messages.reactions.create

Sim

Não

spaces.messages.reactions.delete

Sim

Não

spaces.members.create

Sim

Não

spaces.members.delete

Sim

Não

spaces.members.list

Sim

Não

media.upload

Sim

Não