Cette page explique comment les administrateurs Google Workspace peuvent utiliser l'API Google Chat pour gérer les espaces Google Chat dans leur organisation.
Pour gérer les espaces Chat, les administrateurs Google Workspace peuvent utiliser l'outil de gestion des espaces dans la console d'administration Google ou appeler l'API Google Chat. Grâce à l'API Chat, les administrateurs peuvent créer des applications Google Chat qui gèrent des espaces à grande échelle et automatisent leurs tâches courantes ou répétables.
Que peuvent faire les administrateurs avec l'API Chat ?
Un administrateur peut effectuer des tâches de gestion en fonction des rôles d'administrateur qui lui sont attribués.
En tant qu'administrateur Google Workspace, vous pouvez effectuer un certain nombre de tâches de gestion avec l'API Chat, par exemple:
- Rechercher des espaces en fonction de critères spécifiés
- Lister les membres d'un espace
- Ajouter des membres à un espace et en supprimer
- Obtenir des informations sur un membre et un espace
- Mettre à jour ou supprimer un espace
- Modifier l'appartenance d'un utilisateur à un groupe
S'authentifier et s'autoriser en tant qu'administrateur Google Workspace
Lorsque vous utilisez l'API Chat pour des tâches de gestion, les administrateurs peuvent authentifier et autoriser les requêtes en invoquant des privilèges d'administrateur ou en configurant une délégation au niveau du domaine de l'autorité pour le compte de service d'une application.
Le tableau suivant décrit les méthodes d'authentification disponibles pour les administrateurs lorsqu'ils utilisent l'API Chat.
| Authentification des utilisateurs | Qui appelle la méthode API | Ce que les utilisateurs voient dans Chat |
|---|---|---|
| Droits d'administrateur | Administrateur avec useAdminAccess=true
|
"L'administrateur de l'organisation a effectué [une action]." Par exemple : "L'administrateur de l'organisation a attribué le rôle de gestionnaire de l'espace à Kiran B." Il n'identifie pas le nom ni l'ID utilisateur de l'administrateur, ni le nom de l'application Chat. |
| Délégation au niveau du domaine | Compte de service au nom d'un utilisateur |
"[Utilisateur] a effectué [une action] via [nom de l'application]." Par exemple, "Sasha T a renommé l'espace "Discussion sur le projet de publication"." L'utilisateur usurpé par le service est identifié comme ayant effectué l'action. |
Utiliser l'API Chat pour votre organisation
Les exemples de cette section montrent comment les administrateurs utilisent l'API Chat pour gérer les espaces et les membres de leur organisation avec des droits d'administrateur.
Les méthodes d'API Chat suivantes activent les droits d'administrateur avec 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()
Gérer les abonnements des utilisateurs à un espace
Les scénarios suivants vous montrent comment, en tant qu'administrateur Google Workspace, vous pouvez gérer l'appartenance des utilisateurs de votre organisation à un espace à l'aide de l'API Chat.
Ajouter des utilisateurs à des espaces
Les administrateurs peuvent ajouter un utilisateur à n'importe quel espace d'une organisation à l'aide de spaces.members.create().
Utilisé avec spaces.search(), les administrateurs peuvent ajouter un utilisateur à un ensemble d'espaces déterminé par sa requête de recherche. Cela peut être utile lors de l'intégration de nouveaux employés dans une organisation, car cela permet aux administrateurs d'automatiser un processus de routine.
Rechercher des utilisateurs et les supprimer d'espaces
À l'aide de spaces.members.get(), les administrateurs peuvent déterminer si un utilisateur (interne ou externe à l'organisation) est membre d'un espace de l'organisation.
Utilisé avec spaces.search(), les administrateurs peuvent trouver tous les espaces dont l'utilisateur est membre, puis les supprimer de ces espaces avec spaces.members.delete().
Cela peut être utile lorsque des employés changent d'équipe au sein d'une organisation ou lorsqu'ils quittent l'entreprise. Cela permet aux administrateurs d'automatiser un processus de routine.
Attribuer le rôle de gestionnaire d'espace à des utilisateurs
À l'aide de spaces.members.patch(), les administrateurs peuvent faire passer les membres d'un espace de ROLE_MEMBER à ROLE_MANAGER.
Les administrateurs peuvent également utiliser spaces.members.patch() pour déplacer des membres de ROLE_MANAGER vers ROLE_MEMBER.
Utilisé avec spaces.search(), les administrateurs peuvent trouver des espaces sans gestionnaire, puis promouvoir un membre existant en tant que ROLE_MANAGER avec spaces.members.patch().
Trouver les membres externes d'un espace
À l'aide de spaces.members.list(), les administrateurs peuvent récupérer la liste des membres d'un espace, les profils utilisateur de l'API People ou de l'API Directory de l'organisation, puis filtrer les résultats pour les membres d'un domaine ou d'une organisation externes.
Pour en savoir plus, consultez la section Comment le chat identifie-t-il les utilisateurs ?.
Auditer et gérer les espaces
Les scénarios suivants vous montrent comment, en tant qu'administrateur Google Workspace, vous pouvez auditer et gérer les espaces de votre organisation avec l'API Chat.
Rechercher et supprimer des espaces inactifs
Les espaces Chat inutilisés peuvent prendre un espace de stockage précieux et encombrer l'interface utilisateur. Les administrateurs peuvent utiliser spaces.search() pour rechercher les espaces inactifs, puis spaces.delete() pour les supprimer. Pour en savoir plus et obtenir un exemple de code, consultez la section Rechercher et supprimer des espaces Chat inactifs.
Auditer les espaces de l'organisation
À l'aide de spaces.search(), les administrateurs peuvent récupérer la liste de tous les espaces d'une organisation, accompagnée d'informations détaillées sur leurs paramètres et leurs métadonnées (par exemple, date de création, date de la dernière activité, nombre de membres, état du paramètre d'historique et possibilité d'inviter des personnes externes).
Exporter une liste d'espaces en fonction de critères de recherche
À l'aide de spaces.search(), les administrateurs peuvent récupérer la liste des espaces qui répondent aux critères spécifiés dans query et exporter les résultats dans un fichier CSV à des fins d'analyse.
Rechercher des membres d'un espace en fonction de critères de recherche
À l'aide de spaces.members.list(), les administrateurs peuvent récupérer la liste des membres de n'importe quel espace de l'organisation et analyser les résultats en fonction de critères spécifiques.
Trouver les gestionnaires d'un espace
À l'aide de spaces.members.list(), les administrateurs peuvent récupérer la liste des membres d'un espace filtré sur MembershipState=ROLE_MANAGER.
Pour trouver tous les administrateurs d'espaces de votre organisation, dans tous les espaces, vous pouvez utiliser spaces.search() pour les lister tous. Ensuite, pour chaque espace de la liste, utilisez spaces.members.list pour récupérer les administrateurs.
Articles associés
- S'authentifier et autoriser l'accès à l'aide de droits d'administrateur
- Rechercher et gérer des espaces Google Chat avec l'API Google Chat en tant qu'administrateur Google Workspace
- Méthode
spaces.search()