Comment récupérer les groupes d'utilisateurs dans Zoho

La récupération des groupes d'utilisateurs dans Zoho CRM nécessite de comprendre le contexte produit dans lequel vous travaillez, car les groupes d'utilisateurs fonctionnent différemment dans l'écosystème Zoho. Ce guide couvre les méthodes principales pour accéder et récupérer les informations de groupes.

Pourquoi c'est important

Les groupes d'utilisateurs vous aident à organiser et segmenter votre base d'utilisateurs pour un meilleur contrôle d'accès, des rapports et des analyses. Que vous gériez les permissions dans Zoho Analytics, organisiez les utilisateurs par attributs dans Zoho Apptics, ou contrôliez l'accès aux documents dans Zoho Sign, savoir comment récupérer les données de groupes est essentiel pour l'administration et la conformité.

Étape par étape

Étape 1. Déterminez votre contexte produit

Les groupes d'utilisateurs existent dans plusieurs produits Zoho avec différentes méthodes de récupération. Identifiez si vous travaillez avec Zoho Analytics (sur site), Zoho Apptics (analyse mobile), ou Zoho Sign (gestion de documents). Chacun dispose d'API et d'interfaces distinctes pour accéder aux informations de groupes.

Étape 2. Pour Zoho Analytics sur site : Authentifiez-vous avec OAuth

Configurez l'authentification OAuth en obtenant votre jeton d'accès à partir du point de terminaison des comptes Zoho. Incluez votre clientid, clientsecret, et refreshtoken dans une requête POST vers https://accounts.zoho.com/oauth/v2/token avec granttype défini sur refreshtoken. Stockez le accesstoken retourné dans vos en-têtes de requête en tant que Authorization: Zoho-oauthtoken <access_token> ^[3].

Étape 3. Appelez le point de terminaison de l'API GROUPINFO

Envoyez une requête POST vers https://analyticsapi.zoho.com/api/<email>/<workspaceName> avec les paramètres suivants : définissez ZOHOACTION sur GROUPINFO, ZOHOOUTPUTFORMAT sur JSON, ZOHOERRORFORMAT sur JSON, et ZOHOAPI_VERSION sur 1.0 ^[3]. Incluez votre en-tête d'autorisation de l'étape 2.

Étape 4. Analysez la réponse des métadonnées de groupe

L'API retourne un tableau JSON contenant tous les groupes de votre espace de travail. Chaque objet de groupe inclut groupId, groupName, groupDescription, createdTime, et membersList (un tableau d'adresses e-mail des membres) ^[3]. Extrayez les groupes dont vous avez besoin de cette réponse pour un traitement ultérieur.

Étape 5. Pour Zoho Apptics : Affichez les groupes dans la console

Accédez à Marketer > User groups dans le menu de gauche pour voir les groupes d'utilisateurs actifs, nouveaux et inactifs pour votre plage de dates sélectionnée ^[1]. Cette interface affiche le nombre total de groupes et une liste détaillée montrant le nom du groupe, la date et l'heure d'enregistrement, la dernière session active, les nouveaux utilisateurs, les utilisateurs actifs, les nouveaux appareils et les appareils actifs ^[1].

Étape 6. Cliquez sur les groupes individuels pour des informations détaillées

Sélectionnez n'importe quel groupe d'utilisateurs dans la liste pour accéder aux analyses granulaires spécifiques à ce groupe ^[1]. Cela vous permet d'analyser quels segments favorisent l'adoption et d'identifier les modèles d'utilisation entre différentes catégories d'utilisateurs.

Pièges courants

• Limitation d'attribut unique dans Apptics : Vous ne pouvez grouper les utilisateurs que par un seul attribut à la fois (comme l'organisation, la région ou la langue) ^[1]. Planifiez votre stratégie de groupement en conséquence.
• Exigences de permission : Seuls les administrateurs serveur et les propriétaires d'espace de travail peuvent récupérer les listes d'utilisateurs et les informations de groupes via l'API Analytics ^[7]. Assurez-vous que votre compte dispose du rôle nécessaire.
• Contexte de l'espace de travail : Incluez toujours le nom d'espace de travail correct dans votre URI API. Les requêtes sans un espace de travail valide échoueront.

Ce qu'il faut vérifier

• Vérifiez que votre jeton OAuth est valide et n'a pas expiré avant d'effectuer des appels API
• Confirmez que l'adresse e-mail et le nom d'espace de travail dans votre URI de requête correspondent exactement à votre compte Zoho Analytics
• Examinez le tableau membersList dans la réponse pour vous assurer que tous les membres de groupe attendus sont présents

---

*Cet article est fourni par Beam Help — support expert indépendant pour Zoho. Nous ne sommes pas le support officiel de Zoho.*