Puoi cercare gruppi che corrispondono a determinati attributi con il metodo
groups.list dell'API
Directory. Questo metodo accetta il parametro query, ovvero una query di ricerca che combina una o più clausole di ricerca. Ogni clausola di ricerca è composta da
tre parti:
- Campo
- Attributo di gruppo in cui viene eseguita la ricerca. Ad esempio,
name. - Operatore
- Test eseguito sui dati per fornire una corrispondenza. Ad esempio, l'operatore
=verifica se un attributo di testo corrisponde a un valore. - Valore
- Il contenuto dell'attributo testato. Ad esempio,
groupName.
Più clausole sono separate da uno spazio vuoto e sono unite implicitamente da un operatore
AND.
Campi
| Campo | Tipo di valore | Operatori | Descrizione |
|---|---|---|---|
email |
stringa | =, :{PREFIX}* |
L'indirizzo email del gruppo. Nota: questo parametro non può essere utilizzato con il parametro memberKey nella stessa query. |
name |
stringa | =, :{PREFIX}* |
Il nome visualizzato del gruppo. Nota: questo parametro non può essere utilizzato con il parametro memberKey nella stessa query. |
memberKey |
stringa | =, |
Il parametro di query memberKey restituisce tutti i gruppi per i quali un utente o un gruppo ha un'iscrizione. Questo valore può essere uno qualsiasi degli indirizzi email principali o alias dell'utente, l'indirizzo email principale o alias di un gruppo o l'ID univoco di un utente. Nota: questo parametro non può essere utilizzato insieme ai parametri email o name nella stessa query. |
Tipi di valori
| Tipo di valore | Note |
|---|---|
| stringa | Raccolgi tra virgolette singole ' se la query contiene spazi vuoti. Esegui l'escape delle virgolette singole nelle query con \', ad esempio 'Valentine\'s Day'. |
Operatori
| Operatore | Tipi di valori supportati | Note |
|---|---|---|
= |
stringa, booleano, numero, data | Il campo e il valore corrispondono esattamente. Ad esempio, name=contact corrisponde a tutti i gruppi con l'attributo name "contact", ma non a "contactgroup". Supportato dalla maggior parte dei campi stringa (vedi sopra). |
:{PREFIX}* |
stringa | Il campo inizia con il valore. Ad esempio, una query con email:support* corrisponde a gruppi con valori email di "supportgroup@" e "support@", ma non "contactsupport". Supportato solo su un insieme limitato di campi stringa (vedi sopra). |
Esempi
Tutte le query utilizzano il metodo groups.list, che ha una richiesta HTTP simile alla seguente (interruzioni di riga incluse per leggibilità):
GET https://admin.googleapis.com/admin/directory/v1/groups ?domain=primary domain &query=query parameters
I parametri query devono essere codificati nell'URL. Ad esempio, la query
query=email:support* viene codificata nell'URL come query=email%3Asupport*.
Tutti gli esempi in questa pagina mostrano parametri query non codificati.
Le librerie client gestiscono automaticamente la codifica dell'URL.
Cercare un gruppo per nome visualizzato
name='contact'
Cercare gruppi che corrispondono a un prefisso email
email:admin*
Cercare tutti i gruppi di un utente
memberKey=user@company.com
Cerca gruppi con nome ed email che iniziano con il contatto
name:contact* email:contact*