Gérer des espaces Google Chat en tant qu'administrateur Google Workspace

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.

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, telles que les suivantes :

S'authentifier et autoriser l'accès en tant qu'administrateur Google Workspace

Lorsque les administrateurs utilisent l' API Chat pour des tâches de gestion, ils peuvent authentifier et autoriser les requêtes en invoquant des droits d'administrateur ou en configurant la délégation d'autorité au niveau du domaine pour le compte de service d'une application.

Le tableau suivant décrit les méthodes d'authentification des 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 fait passer Kiran B au rôle de gestionnaire de l'espace."

Le nom ou l'ID utilisateur de l'administrateur, ni le nom de l'application Chat ne sont identifiés.
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 en "Discussion sur le projet de lancement"."

L'utilisateur dont l'identité est usurpé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 lorsqu'ils gèrent 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.

Gérer les abonnements des utilisateurs aux espaces

En tant qu'administrateur Google Workspace, vous pouvez gérer l'abonnement des utilisateurs de votre organisation aux espaces avec l'API Chat de différentes manières, comme dans les scénarios suivants.

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 méthode permet aux administrateurs d'ajouter un utilisateur à un ensemble d'espaces déterminés par leur 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ée conjointement avec spaces.search, cette méthode permet aux administrateurs de trouver tous les espaces dont l'utilisateur est membre, puis de le 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'organisation, car cela permet aux administrateurs d'automatiser un processus de routine.

Promouvoir des utilisateurs au rôle de gestionnaire d'espace

À l'aide de spaces.members.patch, les administrateurs peuvent modifier le rôle d'un membre en mettant à jour son MembershipRole parmi les options suivantes :

  • ROLE_MEMBER : membre de l'espace. Dans l'UI Chat, ce rôle est appelé Membre.
  • ROLE_ASSISTANT_MANAGER : gestionnaire d'espace. Dans l'UI Chat, ce rôle est appelé Gestionnaire.
  • ROLE_MANAGER : propriétaire de l'espace. Dans l'UI Chat, ce rôle est appelé Propriétaire.

Utilisée conjointement avec spaces.search, cette méthode permet aux administrateurs de trouver les espaces qui n'ont pas de gestionnaire ni de propriétaire, puis de promouvoir un membre existant au rôle de gestionnaire ou de propriétaire avec spaces.members.patch.

Rechercher 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 externe. Pour en savoir plus, consultez Comment Chat identifie les utilisateurs.

Auditer et gérer les espaces

En tant qu'administrateur Google Workspace, vous pouvez auditer et gérer les espaces de votre organisation avec l'API Chat de différentes manières, comme dans les scénarios suivants.

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 des conseils supplémentaires et un exemple de code, consultez Rechercher et supprimer les 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, telles que la date de création, la date de la dernière activité, le nombre de membres, l'état du paramètre d'historique et la 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 une liste d'espaces qui répondent aux critères spécifiés dans le query et exporter les résultats dans un fichier CSV pour analyse.

Rechercher les 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.

Rechercher 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ée sur MembershipState=ROLE_MANAGER.

Pour trouver tous les gestionnaires d'espace 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 gestionnaires.