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 espacios de Google Chat en su organización.
Para administrar 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:
- Busca espacios según criterios especificados
- Enumera los miembros de un espacio
- Agrega miembros a un espacio y quítalos de él
- Obtén detalles sobre un miembro y un espacio
- Actualiza o borra un espacio
- Actualiza la membresía de un usuario
Cómo autenticarse y autorizar como administrador de Google Workspace
Cuando se usa 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 de 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 del usuario 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 sobre el proyecto de lanzamiento". El usuario al que el servicio suplanta 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.
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
Administra las membresías de los usuarios en los espacios
Las siguientes situaciones son formas en las que, como administrador de Google Workspace, puedes administrar la membresía de los usuarios de tu organización en el espacio 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.
Si se usa junto con spaces.search(), los administradores pueden agregar un usuario a un conjunto de espacios determinados por su búsqueda. Esto puede ser útil cuando se incorporan nuevos empleados a una organización, ya que permite a los administradores automatizar un proceso de rutina.
Buscar usuarios y quitarlos de los espacios
Con spaces.members.get(), los administradores pueden determinar si un usuario (interno o externo a la organización) es miembro de cualquier espacio de la organización.
Si se usa junto con spaces.search(), los administradores pueden encontrar todos los espacios de los que es miembro el usuario y, luego, quitarlo de los espacios con spaces.members.delete().
Esto puede ser útil cuando los empleados cambian de equipo dentro de una organización o desvinculan a los empleados que ya no están en la organización, ya que permite a los administradores automatizar un proceso de rutina.
Asciende a usuarios a administradores del espacio
Con spaces.members.patch(), los administradores pueden ascender a los miembros de un espacio de ROLE_MEMBER a ROLE_MANAGER.
Los administradores también pueden usar spaces.members.patch() para mover miembros de ROLE_MANAGER a ROLE_MEMBER.
Si se usa junto con spaces.search(), los administradores pueden encontrar espacios que no tienen un administrador y, luego, ascender a un miembro existente a ROLE_MANAGER con spaces.members.patch().
Cómo encontrar miembros externos de un espacio
Con spaces.members.list(), los administradores pueden recuperar una lista de miembros de un espacio, recuperar los perfiles de usuario de la API de People o de Directory de la organización y, luego, filtrar los resultados de los miembros de un dominio o una organización externos.
Para obtener más información, consulta
Cómo identifica a los usuarios el chat.
Audita y administra espacios
Las siguientes situaciones son formas en las que, como administrador de Google Workspace, puedes auditar y administrar los espacios de tu organización con la API de Chat.
Busca y borra espacios inactivos
Los espacios de Chat que no se usan pueden ocupar espacio de almacenamiento valioso y generar 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 Cómo buscar y borrar espacios de Chat inactivos.
Cómo auditar espacios en 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 invitados externos.
Cómo exportar una lista de espacios según criterios de búsqueda
Con spaces.search(), los administradores pueden recuperar una lista de espacios que cumplen con los criterios especificados en query y exportar los resultados a un archivo CSV para su análisis.
Cómo encontrar miembros de un espacio según 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 en función de criterios específicos.
Cómo encontrar 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 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 los administradores.
Temas relacionados
- Autentica y autoriza el uso de los privilegios de administrador
- Cómo buscar y administrar espacios de Google Chat con la API de Google Chat como administrador de Google Workspace
- Método
spaces.search()