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 do 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 nos espaços do modo de importação, você precisa autenticar os 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 do modo de importação precisam ter esse escopo do OAuth. Depois que a conta de serviço tiver autoridade em todo o domínio delegada para esse escopo, os apps do Chat poderão acessar os espaços do modo de importação representando uma conta de usuário.

Em alguns cenários, a conta de usuário para representação pode não estar mais disponível. Nesses casos, o app do Chat pode usar as credenciais da conta de serviço como substituto. Por exemplo, se você excluir uma conta de usuário usada durante a criação da mensagem, o app do Chat poderá usar as próprias credenciais da conta de serviço para criar uma mensagem com o mesmo conteúdo. Os apps do Chat podem acessar os espaços do modo de importação como um app usando credenciais de conta de serviço com o seguinte escopo 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 de modo de importação criados por eles, e não para os espaços de modo de importação criados por outros apps.

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

Método de recurso

Compatível com representação de usuário

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