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 espaços do Google Chat em toda a organização.

Para gerenciar espaços do Chat, os administradores do Google Workspace podem usar a ferramenta de gerenciamento 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 maneiras de autenticação de 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

"[Usuário] realizou [uma ação] pelo [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 falsificado pelo serviço é identificado como tendo realizado a ação.

Usar a API Chat para sua organização

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

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

Gerenciar as assinaturas dos usuários nos espaços

Os cenários a seguir são formas de gerenciar a associação de espaço dos usuários na sua organização com a API Chat.

Adicionar usuários a espaços

Usando o spaces.members.create(), os administradores podem adicionar um usuário a qualquer espaço em 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 os administradores automatizem um processo de rotina.

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

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

Usado em conjunto com spaces.search(), os administradores podem encontrar todos os espaços em que o usuário é membro e removê-los deles com spaces.members.delete(). Isso pode ser útil quando os funcionários mudam de equipe dentro de uma organização ou saem da organização. Isso permite que os administradores automatizem um processo de rotina.

Promover usuários a administradores do espaço

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

Usando 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 extrair uma lista de membros em um espaço, extrair os perfis de usuário da API People ou 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 auditar e gerenciar os espaços na sua organização com a API Chat como administrador do Google Workspace.

Encontrar e excluir espaços inativos

Espaços do Chat não usados podem ocupar 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 spaces.delete() para excluí-los. Para mais orientações e um exemplo de código, consulte Encontrar e excluir espaços de chat inativos.

Fazer auditoria de espaços na organização

Usando spaces.search(), os administradores podem extrair 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 convidados externos.

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

Usando spaces.search(), os administradores podem extrair uma lista de espaços que atendem aos critérios especificados no 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 extrair uma lista de membros de qualquer espaço na organização e analisar os resultados de acordo com critérios específicos.

Encontrar os administradores de um espaço

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

Para encontrar todos os administradores de espaços 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 extrair os administradores.