Vous pouvez rechercher des groupes correspondant à certains attributs à l'aide de la
groups.list méthode de l'
API Directory. Cette méthode accepte le paramètre query, qui est une requête de recherche combinant une ou plusieurs clauses de recherche. Chaque clause de recherche comporte trois parties :
- Champ
- Attribut de groupe dans lequel la recherche est effectuée. Par exemple,
name. - Opérateur
- Test effectué sur les données pour fournir une correspondance. Par exemple, l'opérateur
=teste si un attribut de texte correspond à une valeur. - Valeur
- Contenu de l'attribut testé. Par exemple,
groupName.
Plusieurs clauses sont séparées par des espaces et sont jointes implicitement par un opérateur AND.
Champs
| Champ | Type de valeur | Opérateurs | Description |
|---|---|---|---|
email |
chaîne | =, :{PREFIX}* |
Adresse e-mail du groupe. Remarque : Ce paramètre ne peut pas être utilisé avec le paramètre memberKey dans la même requête. |
name |
chaîne | =, :{PREFIX}* |
Nom à afficher du groupe. Remarque : Ce paramètre ne peut pas être utilisé avec le paramètre memberKey dans la même requête. |
memberKey |
chaîne | =, |
Le paramètre de requête memberKey renvoie tous les groupes pour lesquels un utilisateur ou un groupe est membre. Cette valeur peut correspondre à l'adresse e-mail principale ou d'alias d'un utilisateur, à l'adresse e-mail principale ou d'alias d'un groupe, ou à l'ID unique d'un utilisateur. Remarque : Ce paramètre ne peut pas être utilisé avec les paramètres email ou name dans la même requête. |
Types de valeurs
| Type de valeur | Remarques |
|---|---|
| chaîne | Placez la chaîne entre guillemets simples ' si la requête contient des espaces. Échappez les guillemets simples dans les requêtes avec \', par exemple 'Valentine\'s Day'. |
Opérateurs
| Opérateur | Types de valeurs acceptés | Remarques |
|---|---|---|
= |
chaîne, booléen, nombre, date | Le champ et la valeur correspondent exactement. Par exemple, name=contact correspond à tous les groupes dont l'attribut name est "contact", mais pas à "contactgroup". Compatible avec la plupart des champs de chaîne (voir ci-dessus). |
:{PREFIX}* |
chaîne | Le champ commence par la valeur. Par exemple, une requête avec email:support* correspond aux groupes dont les valeurs email sont "supportgroup@", et "support@" mais pas "contactsupport". Compatible uniquement avec un ensemble limité de champs de chaîne (voir ci-dessus). |
Exemples
Toutes les requêtes utilisent la groups.list
méthode, qui comporte une requête HTTP semblable à la suivante (sauts de ligne inclus pour plus de lisibilité) :
GET https://admin.googleapis.com/admin/directory/v1/groups ?domain=primary domain &query=query parameters
Les paramètres query doivent être encodés au format URL. Par exemple, la requête query=email:support* est encodée au format URL sous la forme query=email%3Asupport*.
Tous les exemples de cette page affichent des paramètres query non encodés.
Les bibliothèques clientes gèrent automatiquement cet encodage URL.
Rechercher un groupe par nom à afficher
name='contact'
Rechercher des groupes correspondant à un préfixe d'adresse e-mail
email:admin*
Rechercher tous les groupes d'un utilisateur
memberKey=user@company.com
Rechercher des groupes dont le nom et l'adresse e-mail commencent par "contact"
name:contact* email:contact*