Gerenciar espaços do Google Chat como administrador do Google Workspace

Esta página oferece uma visão geral de como os administradores do Google Workspace podem usar a API Google Chat para gerenciar os espaços do Google Chat na organização.

Para gerenciar os espaços do Chat, os administradores do Google Workspace podem usar a ferramenta de gestão de espaços no Admin Console do Google ou chamar a API Google Chat. Ao usar a API Chat, os administradores podem criar apps do Google Chat que gerenciam espaços em grande escala e automatizam tarefas comuns ou repetitivas.

O que os administradores podem fazer com a API Chat

Um administrador pode realizar tarefas de gerenciamento com base nas funções de administrador atribuídas.

Como administrador do Google Workspace, você pode realizar várias tarefas de gerenciamento com a API Chat, como:

Como autenticar e autorizar como administrador do Google Workspace

Ao usar a API Chat para tarefas de gerenciamento, os administradores podem autenticar e autorizar solicitações invocando privilégios de administrador ou configurando a delegação de autoridade em todo o domínio para a conta de serviço de um aplicativo.

A tabela a seguir descreve as formas de autenticação dos administradores ao usar a API Chat.

Autenticação de usuários Quem chama o método da API O que os usuários veem no Chat
Privilégios de administrador Administrador com useAdminAccess=true

"O administrador da organização realizou [uma ação]."

Por exemplo, "O administrador da organização mudou Kiran B para administrador do espaço".

Ele não identifica o nome ou o ID do usuário administrador nem o nome do app Chat.
Delegação em todo o domínio Conta de serviço em nome de um usuário

"[User] fez [uma ação] no [nome do app]."

Por exemplo, "Sasha T renomeou o espaço para Discussão sobre o projeto de lançamento".

O usuário que está sendo personificado pelo serviço é identificado como tendo realizado a ação.

Usar a API Chat na sua organização

Os exemplos nesta seção mostram como os administradores usam a API Chat ao gerenciar os espaços e membros da organização com privilégios de administrador.

Os seguintes métodos da API Chat ativam privilégios de administrador com useAdminAccess=true.

Gerenciar as assinaturas de espaço dos usuários

Confira a seguir algumas maneiras de gerenciar a participação no espaço dos usuários da sua organização com a API Chat como administrador do Google Workspace.

Adicionar usuários a espaços

Usando spaces.members.create(), os administradores podem adicionar um usuário a qualquer espaço de uma organização.

Usado em conjunto com spaces.search(), os administradores podem adicionar um usuário a um conjunto de espaços determinado pela consulta de pesquisa. Isso pode ser útil ao integrar novos funcionários a uma organização, permitindo que administradores automatizem um processo rotineiro.

Encontrar usuários e removê-los de espaços

Usando o spaces.members.get(), os administradores podem determinar se um usuário (interno ou externo à organização) é membro de algum espaço na organização.

Usado em conjunto com spaces.search(), os administradores podem encontrar todos os espaços de que o usuário faz parte e removê-lo deles com spaces.members.delete(). Isso pode ser útil quando os funcionários mudam de equipe dentro de uma organização ou quando os funcionários que não estão mais na organização são desligados. Assim, os administradores podem automatizar um processo rotineiro.

Promover usuários a administradores do espaço

Usando spaces.members.patch(), os admins podem promover participantes de um espaço de ROLE_MEMBER para ROLE_MANAGER. Os administradores também podem usar spaces.members.patch() para mover membros de ROLE_MANAGER para ROLE_MEMBER.

Usado em conjunto com spaces.search(), os administradores podem encontrar espaços sem um administrador e promover um membro a ROLE_MANAGER com spaces.members.patch().

Encontrar participantes externos de um espaço

Usando spaces.members.list(), os administradores podem recuperar uma lista de membros em um espaço, os perfis de usuário da API People ou da API Directory da organização e filtrar os resultados para aqueles que são membros de um domínio ou organização externa. Para mais informações, consulte Como o chat identifica os usuários.

Auditar e gerenciar espaços

Os cenários a seguir são maneiras de você, como administrador do Google Workspace, auditar e gerenciar os espaços na sua organização com a API Chat.

Encontrar e excluir espaços inativos

Os espaços do Chat não usados podem ocupar um espaço de armazenamento valioso e criar desordem na interface do usuário. Os administradores podem usar spaces.search() para encontrar os espaços inativos e depois spaces.delete() para excluí-los. Para mais orientações e um exemplo de código, consulte Encontrar e excluir espaços inativos do Chat.

Auditar espaços na organização

Usando spaces.search(), os administradores podem recuperar uma lista de todos os espaços de uma organização com informações detalhadas sobre as configurações e os metadados de cada espaço, como data de criação, data da última atividade, número de membros, status da configuração de histórico e capacidade de convidar pessoas externas.

Exportar uma lista de espaços com base em critérios de pesquisa

Usando spaces.search(), os administradores podem recuperar uma lista de espaços que atendem aos critérios especificados em query e exportar os resultados para um arquivo CSV para análise.

Encontrar participantes de um espaço com base em critérios de pesquisa

Usando spaces.members.list(), os administradores podem recuperar uma lista de membros de qualquer espaço na organização e analisar os resultados de acordo com critérios específicos.

Encontrar administradores de um espaço

Usando spaces.members.list(), os administradores podem recuperar uma lista de participantes de um espaço filtrada para MembershipState=ROLE_MANAGER.

Para encontrar todos os administradores de espaço na sua organização, em todos os espaços, use spaces.search() para listar todos eles. Em seguida, para cada espaço na lista, use spaces.members.list para recuperar os administradores.