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. En utilisant l'API Chat, les administrateurs peuvent créer des applications Google Chat qui gèrent les espaces à grande échelle et automatisent leurs tâches courantes ou répétables.
Ce que les administrateurs peuvent faire 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
- Modifier ou supprimer un espace
- Modifier l'abonnement d'un utilisateur
S'authentifier et s'autoriser en tant qu'administrateur Google Workspace
Lorsqu'ils utilisent l'API Chat pour les tâches de gestion, les administrateurs peuvent authentifier et autoriser les requêtes en invoquant les droits d'administrateur ou en configurant la 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 dont disposent les administrateurs lorsqu'ils utilisent l'API Chat.
| Authentification des utilisateurs | Qui appelle la méthode API ? | Ce que voient les utilisateurs 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 accordé à Kiran B le rôle de gestionnaire de l'espace." 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 lancement"." L'utilisateur dont l'identité est empruntée 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 de l'API Chat suivantes permettent d'accorder des 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 aux espaces
Les scénarios suivants vous montrent comment, en tant qu'administrateur Google Workspace, vous pouvez gérer l'appartenance des utilisateurs de votre organisation à des espaces avec l'API Chat.
Ajouter des utilisateurs à des espaces
À l'aide de spaces.members.create(), les administrateurs peuvent ajouter un utilisateur à n'importe quel espace d'une organisation.
Utilisée conjointement avec spaces.search(), cette fonctionnalité permet aux administrateurs d'ajouter un utilisateur à un ensemble d'espaces déterminés par sa requête de recherche. Cela peut être utile lors de l'intégration de nouveaux employés à une organisation, car cela permet aux administrateurs d'automatiser un processus de routine.
Rechercher des utilisateurs et les supprimer des 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é conjointement avec spaces.search(), les administrateurs peuvent trouver tous les espaces dont l'utilisateur est membre, puis le supprimer des espaces avec spaces.members.delete().
Cela peut être utile lorsque des employés changent d'équipe au sein d'une organisation ou lorsque des employés qui ne font plus partie de l'organisation sont désactivés. Les administrateurs peuvent ainsi automatiser un processus de routine.
Promouvoir des utilisateurs au rôle de gestionnaire d'espace
À l'aide de spaces.members.patch(), les administrateurs peuvent attribuer aux membres d'un espace le rôle ROLE_MANAGER au lieu de ROLE_MEMBER.
Les administrateurs peuvent également utiliser spaces.members.patch() pour déplacer des membres de ROLE_MANAGER vers ROLE_MEMBER.
Utilisé conjointement avec spaces.search(), les administrateurs peuvent trouver les espaces qui n'ont pas de gestionnaire, puis promouvoir un membre existant au rôle 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, récupérer les profils utilisateur à partir de l'API People ou de l'API Directory de l'organisation, puis filtrer les résultats pour ceux qui sont membres d'un domaine ou d'une organisation externes.
Pour en savoir plus, consultez Comment le chat identifie 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 les espaces inactifs
Les espaces Chat inutilisés peuvent occuper un espace de stockage précieux et encombrer l'interface utilisateur. Les administrateurs peuvent utiliser spaces.search() pour trouver les espaces inactifs, puis spaces.delete() pour les supprimer. Pour obtenir d'autres conseils et un exemple de code, consultez 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 les paramètres et les métadonnées de chaque espace (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 pour 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 selon des critères spécifiques.
Trouver les administrateurs d'un espace
À l'aide de spaces.members.list(), les administrateurs peuvent récupérer une liste des membres d'un espace filtrée 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. 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()