Administra espacios de Google Chat como administrador de Google Workspace

En esta página, se proporciona una descripción general de cómo los administradores de Google Workspace pueden usar la API de Google Chat para administrar los espacios de Google Chat en su organización.

Para administrar los espacios de Chat, los administradores de Google Workspace pueden usar la Herramienta de administración de espacios en la Consola del administrador de Google o llamar a la API de Google Chat. Con la API de Chat, los administradores pueden crear apps de Google Chat que administren espacios a gran escala y automaticen sus tareas comunes o repetibles.

Qué pueden hacer los administradores con la API de Chat

Un administrador puede realizar tareas de administración según sus roles de administrador asignados.

Como administrador de Google Workspace, puedes realizar varias tareas de administración con la API de Chat, como las siguientes:

Cómo autenticar y autorizar como administrador de Google Workspace

Cuando usan la API de Chat para tareas de administración, los administradores pueden autenticar y autorizar solicitudes invocando privilegios de administrador o configurando la delegación de autoridad en todo el dominio para la cuenta de servicio de una aplicación.

En la siguiente tabla, se describen las formas en que los administradores pueden autenticarse cuando usan la API de Chat.

Autenticación de usuarios Quién llama al método de la API Qué ven los usuarios en Chat
Privilegios de administrador Administrador con useAdminAccess=true

"El administrador de la organización realizó [una acción]".

Por ejemplo, "El administrador de la organización cambió a Kiran B a administrador del espacio".

No identifica el nombre ni el ID de usuario del administrador, ni el nombre de la app de Chat.
Delegación de todo el dominio Cuenta de servicio en nombre de un usuario

"[Usuario] realizó [una acción] a través de [nombre de la app]".

Por ejemplo, "Sasha T cambió el nombre del espacio a Discusión del proyecto de lanzamiento".

El usuario que suplanta el servicio se identifica como el que realizó la acción.

Usa la API de Chat para tu organización

En los ejemplos de esta sección, se muestra cómo los administradores usan la API de Chat cuando administran los espacios y los miembros de su organización con privilegios de administrador.

Los siguientes métodos de la API de Chat habilitan los privilegios de administrador con useAdminAccess=true.

Administra las membresías de los usuarios en los espacios

En las siguientes situaciones, se muestra cómo tú, como administrador de Google Workspace, puedes administrar la membresía de los usuarios en los espacios de tu organización con la API de Chat.

Agrega usuarios a los espacios

Con spaces.members.create, los administradores pueden agregar un usuario a cualquier espacio de una organización.

Cuando se usa junto con spaces.search, los administradores pueden agregar un usuario a un conjunto de espacios determinados por su consulta de búsqueda. Esto puede ser útil cuando se incorporan empleados nuevos a una organización, ya que permite a los administradores automatizar un proceso de rutina.

Busca usuarios y quítalos de los espacios

Con spaces.members.get, los administradores pueden determinar si un usuario (interno o externo a la organización) es miembro de algún espacio de la organización.

Cuando se usa junto con spaces.search, los administradores pueden encontrar todos los espacios de los que el usuario es miembro y, luego, quitarlos de los espacios con spaces.members.delete. Esto puede ser útil cuando los empleados cambian de equipo dentro de una organización o cuando se desvinculan empleados que ya no pertenecen a la organización, ya que permite a los administradores automatizar un proceso de rutina.

Asciende a los usuarios para que sean administradores del espacio

Con spaces.members.patch, los administradores pueden cambiar el rol de un miembro actualizando su MembershipRole entre las siguientes opciones:

  • ROLE_MEMBER: Es un miembro del espacio. En la IU de Chat, este rol se denomina Miembro.
  • ROLE_ASSISTANT_MANAGER: Es un administrador del espacio. En la IU de Chat, este rol se denomina Administrador.
  • ROLE_MANAGER: Es un propietario del espacio. En la IU de Chat, este rol se denomina Propietario.

Cuando se usa junto con spaces.search, los administradores pueden encontrar espacios que no tengan un administrador ni un propietario y, luego, ascender a un miembro existente a administrador o propietario con spaces.members.patch.

Busca miembros externos de un espacio

Con spaces.members.list, los administradores pueden recuperar una lista de miembros en un espacio, recuperar los perfiles de usuario de la API de People o la API de Directory de la organización y, luego, filtrar los resultados para aquellos que son miembros de un dominio o una organización externos. Para obtener más información, consulta Cómo Chat identifica a los usuarios.

Supervisa y administra espacios

En las siguientes situaciones, se muestra cómo tú, como administrador de Google Workspace, puedes supervisar y administrar los espacios de tu organización con la API de Chat.

Busca y borra espacios inactivos

Los espacios de Chat sin usar pueden ocupar espacio de almacenamiento valioso y crear desorden en la interfaz de usuario. Los administradores pueden usar spaces.search para encontrar los espacios inactivos y, luego, spaces.delete para borrarlos. Para obtener más orientación y un código de muestra, consulta Busca y borra espacios de Chat inactivos.

Supervisa los espacios de la organización

Con spaces.search, los administradores pueden recuperar una lista de todos los espacios de una organización con información detallada sobre la configuración y los metadatos de cada espacio, como la fecha de creación, la fecha de la última actividad, la cantidad de miembros, el estado de la configuración del historial y la capacidad de invitar a personas externas.

Exporta una lista de espacios según los criterios de búsqueda

Con spaces.search, los administradores pueden recuperar una lista de espacios que cumplan con los criterios especificados en la query y exportar los resultados a un archivo CSV para su análisis.

Busca miembros de un espacio según los criterios de búsqueda

Con spaces.members.list, los administradores pueden recuperar una lista de miembros de cualquier espacio de la organización y analizar los resultados según criterios específicos.

Busca administradores de un espacio

Con spaces.members.list, los administradores pueden recuperar una lista de miembros de un espacio que se filtra a MembershipState=ROLE_MANAGER.

Para encontrar a todos los administradores de espacios de tu organización, en todos los espacios, puedes usar spaces.search para enumerarlos. Luego, para cada espacio de la lista, usa spaces.members.list para recuperar a los administradores.