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 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 os administradores do domínio do Google Workspace podem conceder esse escopo do OAuth a contas de serviço usando a delegação em todo o domínio. Todos os domínios em que um app do Chat cria espaços no modo de importação precisam ter esse escopo OAuth. Depois que a conta de serviço receber a delegação de autoridade em todo o domínio para esse escopo, os apps do Chat poderão acessar os espaços no modo de importação representando uma conta de usuário.

Em alguns casos, a conta de usuário para representaçã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 usada durante a criação de uma 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 do Chat podem acessar espaços no modo de importação como um app usando credenciais de 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 no modo de importação. Os apps do Chat só podem importar conteúdo para os espaços do modo de importação que eles criam, e não para os espaços do modo de importação criados por outros apps.

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

Método do recurso

Representação de usuário compatível

Credenciais de conta de serviço aceitas

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